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IBM Systems Reference Library 


IBM System/360 Operating System 
Assembler Language 


This publication contains specifications 
for the IBM System/360 Operating System 
Assembler Language (Levels E and F). 


The assembler language is a symbolic 
programming language used to write programs 
for the IBM System/360. The language pro- 
vides a convenient means for representing 
the machine instructions and related data 
necessary to program the IBM System/360. 
The IBM System/360 Operating System Assem- 
bler Program processes the language and 
provides auxiliary functions useful in the 
preparation and documentation of a program, 
and includes facilities for processing the 
assembler macro language. 


' Part I of this publication describes the 
assembler language. 


Part II of this publication describes an 
extension of the assembler language -- the 
macro language -- used to define macro 
instructions. 








PREFACE 


This publication is a reference manual 
for the programmer using the assembler 
language and its features. 

Part I of this publication presents 


information common to all parts of the 
language followed by specific information 
concerning the symbolic machine instruction 
codes and the assembler program functions 
provided for the programmer's use. Part II 
contains a description of the macro lan- 
guage and orocedures for its use. 


Appendixes A through J follow Part II. 
Appendixes A through F are associated with 
Parts I and II and present such items as a 
summary chart for constants, instruction 
listings, character set representations, 
and other aids to programming. Appendix G 
contains macro language summary charts, and 
Appendix H is a sample program. Appendix I 
is a reatures comparison chart of 
System/360 assemblers. Appendix J includes 
samples of macro definitions. 


Knowledge of IBM Systen/360 machine 
operations, particularly storage address- 
ing, data formats, and machine instruction 
formats and functions, is prerequisite to 
using this publication, as is experience 


with programming concepts and techniques or 
completion of basic courses of 
in these 


instruction 


areas. IBM System/360 machine 





operations are discussed in the publication 
IBM System/360: Principles of Operation, 


Form A22-6821. 
assembling, 
interpreting listings, 


Information on program 
linkage editing, executing, 
and assembler pro- 


gramming considerations is provided in IBM 


System/360 Operatin 


System: Assembler (E) 


Programmer's Guide, Form C28-6595 and IBM 
System/360 Operating System: Assembler (F) 


Programmer's Guide, Form C26-3756. 


to 


The following publications are referred 


in this publication: 


IBM  System/360 Operating System: Intro- 
duction, Form C28-6534 


IBM System/360 Operating System: Linkage 


Editor and Loader, Form C28-6538 
IBM System/360 Operating System: Supervisor 


and Data Management Macro Instructions, 
Form C28-6647 


IBM System/360 Operating System: Con- 
cepts and Facilities, Form C28-6535 


IBM System/360 Operating System: Supervisor 
and Data Management Services, Form d 
C28~-6646 


IBM System/360 Operating System: Utili- 
ties, Form C28~-6586 


This is a major revision of, and obsoletes, GC28-6514-6 and Technical Newsletter GN33-8072. 
The major changes are the addition of Assembler F support of the System/370 instructions and 


of weak external references (WXTRN), 


Changes to the text and small changes to illustrations are indicated by a vertical line to the 
left of the change; changec or added illustrations are denoted by the symbol e to the left of 


the caption, 


‘This edition applies to release 20 of IBM System/360 Operating System and to all subsequent 





releases until otherwise indicated in new editions or Technical Newsletters, 


Changes are 


continually made to specifications herein; before using this publication in connection with the 
operations of IBM systems, consult the latest SRL Newsletter, Order No. GN20-0360, for the 


editions that are applicable and current, 


tequests for copies of IBM publications should be made to your IBM representative or to 


the IBM branch office serving your locality. 


A form is provided at the back of this publicaticn for readers” comments. 
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PART I -~ THE ASSEMBLER LANGUAGE 


SECTION 1: INTRODUCTION 


SECTION 2: GENERAL INFORMATION 


SECTION 3: ADDRESSING AND PROGRAM SECTIONING AND LINKING 


SECTION 4: MACHINE INSTRUCTIONS 


SECTION 5: ASSEMBLER INSTRUCTIONS 


Computer programs may be expressed in 
Machine language, i.e., language directly 
interpreted by the computer, or in a sym- 
bolic language, which is much more meaning- 
ful to the programmer. The symbolic lan- 
guage, however, must be translated into 
machine language before the computer can 
execute the progran. This function is 
accomplished by a processing program. 


Of the various symbolic programming lan- 
guages, assembler languages are closest to 
machine language in form and content. The 
assembler language discussed in this manual 
is a symbolic programming language for the 
IBM System/360. It enables the programmer 
to use all IBM System/360 machine func- 
tions, as if he were coding in System/360 
machine language. 


The assembler program that processes the 
language translates symbolic instructions 
into machine-language instructions, assigns 
storage locations, and performs auxiliary 
functions necessary to produce an executa- 
ble machine-language program. 


Compatibility 


System/360 Operating System assemblers 
process source programs written in the 
Basic Programming Support/360 basic assem- 
bler language, the IBM 7090/7094 Support 
Package for IBM System/360 assembler lan- 
guage, the Basic Programming Support Ass- 
embler (8K Tape) language, the Basic Oper- 
ating System Assembler (8K Disk) language, 
and the Disk and Tape Systems Assembler 
language, with the following exceptions: 


1. The XFR assembler instruction is con- 
sidered an invalid mnemonic operation 
code by Operating System/360 assem- 
blers. 


2. The assignment, size, and ordering of 
literal pools may aiffer among the 
assemblers. 


Differences in the macro language for 
System/360 assemblers are described in Sec- 
tion 10 of this publication. 


SECTION 1: INTRODUCTION 


THE ASSEMBLER LANGUAGE 


The basis of the assembler language is a 
collection of mnemonic symbols which rep- 
resent: 


1. System/360 machine-language 
codes. 


operation 


2. Operations (auxiliary functions) to be 
performed by the assembler program. 


The language is augmented by other sym- 
bols, supplied by the programmer, and used 
to represent storage addresses or data. 
Symbols are easier to remember and code 


than their machine-language 
Use of symbols greatly reduces 
effort and error. 


equivalents. 
programming 


The programmer may also create a type of 
instruction called a macro instruction. A 
mnemonic symbol, supplied by the program- 
mer, serves as the operation code of the 
instruction. 


Machine Operation Codes 


The assembler language provides mnemonic 
machine-instruction operation codes for all 
machine instructions in the IBM System/360 
Universal Instruction Set and extended mne- 
monic operation codes for the conditional 
branch instruction. 


Assembler Operation Codes 


The assembler language also contains 
mnemonic assembler-instruction operation 
codes, used to specify auxiliary functions 


to be performed by the assembler. These 
are instructions to the assembler program 
itself and, with a few exceptions, result 
in the generation of no machine-language 
code by the assembler program. 


Macro Instructions 


The assembler language enables the 
grammer to define and use 
instructions. 


pro- 
macro 
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Macro instructions are represented by an 
operation code which stands for a sequence 
of machine and/or assembler instructions. 
Macro instructions used in preparing an 
assembler language source program fall into 
two categories: system macro instructions, 
provided by IBM, which relate the object 
program to components of the operating 
system; and macro instructions created by 
the programmer specifically for use in the 
program at hand, or for incorporation in a 
library, available for future use. 


macro instructions 
writing of a 


Programmer-created 
are used to simplify the 


program and to ensure that a standard 
secuence of instructions is used to 
accomplish a desired function. For 
instance, the logic of a program may 


require the same instruction sequence to be 
executed again and again. Rather than code 
this entire sequence each time it is need- 
ed, the programmer creates a macro 

instruction to represent the sequence and 
then, each time the sequence is needed, the 
programmer simply codes the macro 

instruction statement. During assembly, 
the sequence of instructions represented by 
the macro instruction is inserted in the 
object program. 


Part II of this publication discusses 
the language and procedures for defining 
and using macro instructions. 


THE ASSEMBLER PROGRAM 


The assembler program, also referred to 
as the “assembler," processes the source 
statements written in the assemoler 
Language. 


Processing involves the translation of 
source statements into machine language, 
the assignment of storage locations to 
instructions and other elements of the 
program, and the performance of the auxil- 
lary assembler functions designated by the 
programmer. The output of the assembler 
program is the object program, a machine- 
language translation of the source program. 
The assembler furnishes a printed listing 
of the source statements and object program 


statements and additional information 
useful to the programmer in analyzing his 
program, such as error indications. The 


object program is in the format required by 
the linkage editor component of Operating 
Systen/360. (See the linkage editor publi- 
cation.) 


The amount of main storage allocated to 
the assembler for use during processing 
determines the maximum number of certain 
language elements that may be present in 
the source program. 


PROGRAMMER AIDS 


The assembler provides auxiliary func- 
tions that assist the programmer in check- 
ing and documenting programs, in controll- 
ing address assignment, in segmenting a 
program, in data and symbol definition, in 


generating macro instructions, and in con- 
trolling the assembler itself. Mnemonic 
operation codes for these functions are 
provided in the language. 

Variety in Data Representation: Decimal, 


binary, hexadecimal, or character represen- 
tation of machine-language binary values 
may be employed by the programmer in writ- 
ing source statements. The programmer se- 
lects the representation best suited to his 
purpose. 


Base Register Address Calculation: As dis- 
cussed in IBM System/360: Principles of 
Operation, the System/360 addressing scheme 
requires the designation of a base register 
(containing a base address value) and a 
displacement value in specifying a storage 
location. The assembler assumes the cleri- 
cal burden of calculating storage addresses 
in these terms for the symbolic addresses 
used by the programmer. The programmer 
retains control of base register usage and 
the values entered therein. 


Relocatability: The 
duced by the assembler are in a format 
enabling relocation from the originally 
assigned storage area to any other suitable 
area. 


object programs pro- 


Sectioning and Linking: The assembler lan- 
guage and program provide facilities for 


partitioning an assembly into one or more 
parts called control sections. Control 
sections may be added or deleted when 
loading the object program. Because con- 
trol sections do not have to be loaded 
contiguously in storage, a sectioned pro- 
gram may be loaded and executed even though 
a continuous block of storage large enough 
to accommodate the entire program may not 
be available. 


The assembler allows symbols to be 
defined in one assembly and referred to in 
another, thus effecting a link between 


separately assembled programs. 
mits reference to data 
control between programs. 
sectioning and linking is 
Section 3 under the heading, 
tioning and Linking." 


This per- 
and transfer of 

A discussion of 
contained in 
"Program Sec- 


Program Listings: A listing of the source 
program statements and the resulting object 
program statements may be produced by the 
assembler for each source program it assem- 
bles. The programmer can partly control 
the form and content of the listing. 


Error Indications: As a source program is 
assembled, it is analyzed for actual or 
potential errors in the use of the asseni- 


bler language. Detected errors are indi- 


cated in the program listing. 


OPERATING SYSTEM RELATIONSHIPS 


The assembler is a component of the IBM 
System/360 Operating System and, as _ such, 
functions under control of the operating 
system. The operating system provides the 


assembler with input/output, library, and 
other services needed in assembling a 
source program. In a like manner, the 


object program produced by the assembler 
will normally operate under control of the 
operating system and depend on it for 
input/output and other services. In writ- 
ing the source program, the programmer must 
include statements requesting the desired 
functions from the operating system. These 
statements are discussed in the control 
program services publication. The intro- 
duction and the concepts and facilities 
publications provide further information on 
operating system relationships. 
Input/output considerations are discussed 
in the data management publication. 
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This section presents information about 
assembler language coding conventions and 
assembler source statement structure 
addressing. 


ASSEMBLER LANGUAGE CODING CONVENTIONS 


This subsection discusses the general 
coding conventions associated with use of 
the assembler language. 


Coding Form 


A source program is a sequence of source 
statements that are punched into cards. 
These statements may be written on the 
standard coding form, xX28-6509 (shown in 
Figure 2-1), provided by IBM. One line of 
coding on the form is punched into one 
card. The standard card form, IBM 6509 
(shown in Figure 2-2) can be used for punch- 
ing source statements. The vertical columns 
on the form correspond to card columns. 
Space is provided on the form for program 
identification and instructions to keypunch 
operators. 


The body of the form (Figure 2-1) is 
composed of two fields: the statement 
field, columns 1-71, and the 
identification-~sequence field, columns 


73-80. The identification-sequence field 
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is not part cf a statement and is discussed 


following the subsection "Statement 
Format." 
The entries (i.e., coding) composing a 


statement occupy columns 1-71 of a line 
and, if needed, columns 16-71 of one or two 
successive continuation lines. 


Continuation Lines 


continue a 
following 


When it is 
statement on another 
rules apply. 


1. 
2. 


necessary to 
line, the 


Write the statement up through column 71. 
Enter a continuation character (not blank 
and not part of the coding) in column 72 

of the line. 

Continue the statement in column 16 of the 
next line, leaving columns 1 through 15 
blank. 

If the statement is not finished before 
column 71 of the second line, enter a 
continuation character in column 72, and 
continue in column 16 of the following line. 
The statement has to be finished before 
column 71 of the third line, because the 
maximum number of continuation lines is two. 
Macro instruction can be coded on as many 
lines as are needed. 


These rules assume that normal source 
statement boundaries are used (see"State- 
ment Boundaries" below). 


x28-6508-2 U/MOSO 
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Figure 2-1. Coding Form 
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Statement Boundaries 





Source statements are normally contained 
in columns 1-71 of statement lines and 


columns 16-71 of any continuation lines. 
Therefore, columns 1, 71, and 16 are 
referred to as the "begin," “end," and 
"continue" columns, respectively. (This 
convention can be altered by use of the 
Input Format Control (ICTL) assembler 
instruction discussed later in this publi- 
cation. The continuation character, if 
used, always immediately follows the "end" 
column. 


Statement Format 


Statements may consist of one to four 
entries in the statement field. They are, 
trom left to right: a name entry, an 
operation entry, an operand entry, and a 
comments entry. These entries must be 
separated by one or more blanks, and must 
be written in the order stated. 


The coding form (Figure 2-1) is ruled to 
provide an 8-character name field, a 
5-character operation field, and a 
56~-character operand and/or comments field. 


If desired, the programmer can disregard 


these boundaries and write the name, 
operation, operand, and comment entries in 
other positions, subject to the following 
rules: 


1. The entries must not extend beyond 
statement boundaries within a line 
(either the conventional boundaries 
if no ICTL statement is given, or as 
designated by the programmer via the 
ICTL instruction). 


2. The entries 
sequence, 


must be in 
as stated previously. 


proper 


3. The entries must be Separated by 
or more blanks. 


one 


4%. It used, a name entry must be written 
starting in the begin column. 
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Figure 2-2. 
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5. The name and operation entries must be 
completed in the first line of the 
statement, including at least one ‘ 
blank following the operation entry. 

the name, 


A description of operation, 


operand, and comments entries follows: 
Name Entry: The name entry is a symbol 


created by the programmer to identify a 
statement. A name entry is usually option- 
al. The symbol must consist of eight 
characters or less, and be entered with the 
first character appearing in the begin 
column. The first character must be 
alphabetic. If the begin column is blank, 
the assembler program assumes no name has 
been entered. No blanks can appear in 

the symbol. 


Operation Entry: The operation entry is 
the mnemonic operation code specifying the 
machine operation, assembler, or macro- 
instruction operation desired. An 
operation entry is mandatory and cannot 
appear ina continuation line. It must 
start at least one position to the right of 
the begin column. Valid mnemonic operation 
codes for machine and assembler operations 
are contained in Appendixes D and E of this 
publication. Valid operation codes consist 
of five characters or fewer for machine or 
assembler-instruction operation codes, and 
eight characters or fewer for macro- 
instructicn operation codes. No blanks can 
appear within the operation entry. 


Operand Entries: Operand entries identify 
and describe data to be acted upon by the 
instruction, by indicating such things as 


storage locations, masks, storage-area 
lengths, or types of data. 


Depending on the needs of the instruc- 
tion, one or more or no operands can be 
written. Operands are required for all 
machine instructions, but many assembler 
instructions require no operand. 


Operands must be separated by commas, 
and no blanks can intervene between oper- 
ands and the commas that separate them. 














vwaunecun teoar 


Pryde 





y7777774 2 
Bee8B88E 


The first blank normally indicates the end 
of the operand field. 


The operands cannot contain embedded 
blanks, except as follows: 


If character representation is 
used to specify a constant, a 
literal, or immediate data in an 
operand, the character string can 
contain blanks, e.g., C'A D‘'. 


Comment Entries: Comments are descriptive 
items of information about the program that 
are shown on the program listing. All 256 
valid characters (see Character Set in this 
section), including blanks can be used in 
writing a comment. The entry can follow 
the operand entry and must be separated 
from it by a blank; each line of comment 
entries cannot extend beyond the end 

column (column 71). 


An entire statement field can be used 
for a comment by placing an asterisk in the 
begin column. Extensive comment entries 
can be written by using a series of lines 
with an asterisk in the begin column of 
each line or by using continuation lines. 
Comment entries cannot fall between a 
statement and its continuation line. 


In statements where an optional operand 
entry is omitted but a comment entry is 
desired, the absence of the operand entry 


must be indicated by a comma preceded and 
followed by one or more blanks, as follows: 
Sess Tay con ee poate oe ee ee a 
[Name |Operation |[Operand 1 
}----~--}----------}---------------------- 1 
| | END i COMMENT | 
bese. Pi Se doo ee ee ee ) 


For instructions that cannot contain an 
operand entry, this comma is not needed. 


Note: Macro prototype statements and macro 
instructions without operands will not 
tolerate comments, even if a comma is coded 
as shown above. 


For information on rules for the operand 
field of different assembler instructions, 
refer to the table in Appendix E. 


Statement Example: The following example 
illustrates the use of name, operation, 
operand, and comment entries. A compare 
instruction has been named by the symbol 
COMP; the operation entry (CR) is the 
mnemonic operation code for a register-to- 
register compare operation, and the two 
operands (5,6) designate the two general 
registers whose contents are to be 


compared. The comment entry reminds’ the 
programmer that he is comparing "new sur" 
to "old" with this instruction. 


SSS Stas TSS ee 
Operation |Operand | 


f 
{COMP |CR 


Identification-Sequence Field 


The identification-sequence field of the 
coding form (columns 73-80) is used to 
enter program identification and/or state- 
ment sequence characters. The entry is 
optional. If the field, or a portion ot 
it, is used for program identification, the 
identification is punched in the _ source 
cards and reproduced in the printed listing 
of the source program. 


To aid in keeping source statements in 
order, the programmer can number the cards 
in this field. These characters are 
punched into their respective cards, and 
during assembly the programmer may request 
the assembler to verify this sequence by 


use of the Input Sequence Checking (ISEQ) 
assembler instruction. This instruction is 
discussed in Section 5, under Prograin 
Control Instructions. 
Summary of Statement Format 

The entries in a statement must always 


be separated by at least one blank and must 
be in the following order: name, operation, 
operand(s), comment(s). 


Every statement requires an operation 
entry. Name and comment entries are 
optional. Operand entries are required for 


all machine instructions and most assembler 
instructions. 


The name and operation entries must be 
completed in the first statement line, 
including at least one blank following the 
operation entry. 


The name and operation entries must not 
contain blanks. Operand entries must not 
have blanks preceding or following the 
commas that separate them. 
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A name entry must always start in the 
begin column. 


If the column after the end column is 
blank, the next line must start a new 
statement. If the column after the end 
column is not blank, the following line 
is treated as a continuation line. 


All entries must be contained within the 
designated begin, end, and continue column 
boundaries. 


Section 2: 


General Information 


9.1 


Character Set 


Source statements are written using the 
following characters: 


Letters A through Z, and $, #, @a 

Digits 0 through 9 

Special 

Characters + ~ , = .* () ' “ & blank 
These characters are represented by the 

card-punch combinations and internal bit 

configurations listed in Appendix A. In 

addition, any of the 256 punch combinations 


may be designated anywhere that characters 


May appear between paired apostrophes, in 
comments, and in macro instruction oper- 
ands. 


ASSEMBLER LANGUAGE STRUCTURE 


The basic structure of the language can 
be stated as follows. 


A source statement is composed of: 

» A name entry (usually optional). 

*® An operation entry (required). 

* An operand entry (usually required). 

*» Comments entry (optional). 

A name entry is: 

* A symbol. 

An operation entry is: 

* A mnemonic operation code representing 
a machine, assembler, or ma cro- 
instruction. 

An operand entry is: 


® One or more operands composed of one or 


more expressions, which, in turn, are 
composed of a term or an arithmetic 
combination of terms. 

Operands of machine instructions 
generally represent such things as storage 
locations, general registers, immediate 
data, or constant values. Operands of 


assembler instructions provide the informa- 
tion needed by the assembler program to 
perform the designated operation. 


LO 


Figure 2-3 depicts this structure. 

Terms shown in Figure 2-3 are classed as 
absolute or relocatable. Terms are abso- 
lute or relocatable, depending on the 
effect of program relocation upon them. 
Program relocation is the loading of the 
object program into storage locations other 
than those originally assigned by the 
assembler. A term is absolute if its value 
does not change upon relocation. A term is 
relocatable if its value changes upon relo- 
cation. 


The following subsection "Terms and 
Expressions" discusses these items as out- 
lined in Figure 2-3. 


TERMS AND EXPRESSIONS 


TERMS 


Every term represents a value. This 
value may be assigned by the assembler 
(symbols, symbol length attribute, location 
counter reference) or may be inherent in 
the term itself (self-defining term, 
literal). 


An arithmetic combination of terms is 
reducea to a single value by the assembler. 

The following material discusses each 
type of term and the rules for its use. 


Symbols 


A symbol is a character or combination of 
characters used to represent locations or 
arbitrary values. Symbols, through their 
use in name fields and in operands, provide 
the programmer with an efficient way to 
name and reference a program element. 

There are three types of symbols: 


1. Ordinary symbols. 
2. Variable symbols. 
3. Sequence symbols}, 


Ordinary symbols, created by the pro- 
grammer for use aS a name entry and/or an 
operand, must conform to these rules: 





1. The symbol must not consist of more 
than eight characters. The first 
character must be a letter. The other 
characters may be letters, digits, or 
a combination of the two. 


2. No special characters may be included 
in a symbol. 


3. No blanks are allowed in a symbol. 







Name Entry 


Is a Symbol 
which is an 


Operation Entry 












Is a Mnemonic 
Operation Code 






Machine Assembler Macro 


Ordinary 
Symbol 
(AT or RT) 







2 
Variable Teem 
Symbol 
2 which may be 
any one of 


Sequence 
Symbol 






the following 


A Location 
Counter Refer- 
ence i.e.,* 


(RT) 


A Symbol A Self~ 
e.g+,BETA defining 
{AT or RT) Term (AT) 


which may be 
any one of 
the following 


Hexadecimal Binary Character 
e.g.,X'C4! e.g.,B'101' e.g.,C'ABY 





Instruction Instruction Instruction 







A Literal 
e@.g.,=F'1259' 
(RT) 


Operand Entry 


One or more 
Operands that 


are composed 
of an 





Exp or Exp(Exp) or Exp (Exp, Exp) 


Exp = Expression 


Arithmetic 
Combination 


of Terms 





Symbol Length 


* on Other Symbol. ~ 
Attribute Refer Attribute 
ence €.g., References (AT) 





L*Symbol (AT) 


AT=Absolute Term 


RT=Relocatable Term 


t May be generated by combination of variable symbols and assembler language characters, (Conditional assembly only) 


2 Conditional assembly only. 


Figure 2-3. Assembler Language Structure -- Machine and Assembler Instructions 
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In the following sections, the term 
symbol refers to ordinary symbol. 


The following are valid symbols: 


READER LOO P2 aB4 
A23456 N SA1 
X4F2 S4 #56 
The following symbols are invalid, for 
the reasons noted: 
256B (first character is not 
alphabetic) 
RECORDAREA2 (more than eight characters) 
BCD*34 (contains a special character 
*) 
IN AREA (contains a blank) 


Variable symbols must begin with an 
ampersand (&) followed by one to seven 
letters and/or numbers, the first of which 
must be a letter. Variable symbols are 
used within the source program or macro 
definition to allow different values to be 
assigned to one symbol. A complete dis- 
cussion of variable symbols appears in 
Section 6. 


Sequence symbols consist of a period (.) 
followed by one to seven letters and/or 
numbers, the first of which must be a let- 
ter. Sequence symbols are used to indicate 
the position of statements within the 
source program or macro definition. 
their use the programmer can vary the 
sequence in which statements are processed 
by the assembler program. (See the complete 
discussion in Section 6.) 





NOTE: Sequence symbols and variable symbols 
are used only for the macro language and 
conditional assembly. Programmers who do 
not use these features need not be concerned 
with these symbols. 


YEFINING SYMBOLS: ‘The assembler assigns a 
value to each symbol -ppearing aS a name 
antry in a source statement. The values 
assigned to symbols naming storage areas, 
instructions, constants, and control sec- 
tions are the addresses of the leftmost 
bytes of the storage fields containing the 
named items. Since the addresses of these 
items may change upon program relocation, 
the symbols naming them are considered 
relocatable terms. 





A symbol used aS a nane entry in the 
Equate Symbol (EQU) assembler instruction 
is assigned the value designated in the 
operand entry of the instruction. Since 
the operand entry may represent a relocata- 
ble value or an absolute (i.e., 
nonchanginc) value, the symbol is consid- 
ered a relocatable term or an absolute 
term, depending upon the value it is equat- 
ed to. 


L2 


Through 


The value of a symbol may not be 
tive and may not exceed 224-1. 


nega- 


A symbol is said to be defined when it 
appears as the name of a source statement. 
(A special case of symbol definition is 
discussed in Section 3, under “Program 
Sectioning and Linking.") 


Symbol definition also involves the 
asSignment of a length attribute to the 
symbol. (The assembler maintains an inter- 
nal taple - the symbol table - in which the 
values and attributes of symbols are kept. 


When the assembler encounters a symbol in 
an operand, it refers to the table for the 
values associated with the symbol.) The 


length attribute of a symbol is the length, 
in bytes, of the storage field whose 
address is represented by the symbol. For 
example, a symbol naming an instruction 
that occupies four bytes of storage has a 
length attribute of 4. Note that there are 
exceptions to this rule; for example, in 
the case where a symbol has been defined by 
an equate to location counter value (EQU *) 
or to a self-defining term, the length 
attribute of the symbol is 1. These and 
other exceptions are noted under the 
instructions involved. The length attri- 
bute is never affected by a duplication 
factor. 


PREVIOUSLY DEFINED SYMBOLS: Some instruc- 
tions require that a symbol appearing in 
the operand entry be previously defined. 
This simply means that the symbol, before 
its use in an operand, must have appeare? 
as a name entry in a prior statement. 


GENERAL RESTRICTIONS ON SYMBOLS: A symboi 
may be defined only once in an assembly. 


That is, each symbol used as the name of a 
statement must be unique within that assem- 
bly. However, a symbol may be used in the 
name field more than once as a control 
section name (i.e., defined in the START, 
CSECT, or DSECT assempler statements des- 
cribed in Section 3) because the coding of 
a control section may be suspended and then 
resumed at any subsequent point. The CSECT 
or DSECT statement that resumes the section 
must be named by the same symbol that 
initially named the section; thus, the 
symbol that names the section must be 
repeated. Such usage is not considered to 
be duplication of a symbol definition. 


Self-Defining Terms 


A self-defining term is one whose value 
is inherent in the term. It is not 
assigned a value by the assembler. For 
example, the decimal self-defining term - 
15 - represents a value of 15. The length 
attribute of a self-defining term is always 
1. 


There are four types of self-defining 
terms: decimal, hexadecimal, binary, and 
character. Use of these terms is spoken of 
as decimal, hexadecimal, binary, or charac- 
ter representation of the machine-language 
binary value or bit configuration they 
represent. 


Self-defining terms are classed as abso- 
lute terms, since the values they represent 
do not change upon program relocation. 


USING SELF-DEFINING TERMS: Seif-defining 
terms are the means of specifying machine 
values or nit configurations without equat- 
ing the values to symbol and using the 
symbols. 


Self-defining terms may be used to spec- 
ify such program elements as immediate 
data, masks, registers, addresses, and 
address increments. The type of term se- 
lected (decimal, hexadecimal, binary, or 
character) will depend on what is being 
specified. 


The use of a self-defining term is quite 
distinct from the use of data constants or 
literals. When a self-defining term is 
used in a machine-instruction statement, 
its value is assembled into the instruc- 
tion. When a data constant is referred to 
or a literal is specified in the operand of 
an instruction, its address is assembled 
into the instruction. Selif-defining terms 
are always right-justified; truncation or 
padding with zeros if necessary occurs on 
the left. 


Decimal Self-Defining Term: A decimal 


self-defining term is simply an unsigned 
decimal number written as a sequence of 
decimal digits. High-order zeros may be 
used (e.g., 007). Limitations on the value 
of the term depend on its use. For exam- 
ple, a decimal term that designates a 
general register should have a value 
between 0 and 15; one that represents an 
address should not exceed the size of 
storage. In any case, a decimal term may 
not consist of more than eight digits, or 
exceed 16,777,215 (22% -1). A decimal self- 


defining term is assembled as its binary 
equivalent. Some examples of decimal self- 
defining terms are: 8, 147, 4092, and 
00021. 

Hexadecimal Self-defining Term: A hexa- 


decimal self-defining term consists of one 
to six hexadecimal digits enclosed by 
apostrophes and preceded by the letter xX: 
x'c49', 


Each hexadecimal digit is assembled as 
its four-bit binary equivalent. Thus, a 
hexadecimal term used to represent an 


two hexa- 
value of a 


eight-bit mask would consist of 
decimal digits. The maximum 
hexadecimal term is X'FFFFFF'. 

The hexadecimal digits and their bit 
patterns are as follows: 


O- 0000 4- 0100 8- 1000 C- 1100 
1- 0001 5- 0101 9- 1001 D- 1101 
2- 0010 6- 0110 A- 1010 E- 1110 
3- 0041 7- 0111 B- 1011 F~ 1111 


A table for converting from hexadecimal 
representation to decimal representation is 
provided in Appendix B. 


Binary Self-Defining Term: A binary self- 
defining term is written as an unsigned 


sequence of 1s and 0s enclosed in 
apostrophes and preceded by the letter B, 
as follows: B'10001101'. This term would 
appear in storage as shown, occupying one 


byte. A binary term may have up to 24 bits 
represented. 
Binary representation is used primarily 


in designating bit patterns of masks or in 
logical operations. 


The following example illustrates a 
binary term used as a mask in a Test Under 
Mask (TM) instruction. The contents of 
GAMMA are to be tested, bit by bit, against 
the pattern of bits represented by the 
binary term. 


cm at Sa a a a aa a 1 
|Name |Operation |Operand | 
arma 5 ager a ema Pee Soa ee 4 
[ALPHA |TM |GAMMA,B‘10101101' | 
Coos ols booocesescte Joo See ee es 4 


Character Self-Defining Term: A character 
self-defining term consists of one to three 


characters enclosed by apostrophes. It 
must be preceded by the letter c. All 
letters, decimal digits, and special char- 
acters may be used in a character term. In 
addition, any of the remainder of the 256 
punch combinations may be designated ina 
character self-defining term. Examples of 


character self-defining terms are as fol- 
lows: 

cts" c' ' (blank) 

C'ABC' c'13' 


Because of the use of apostrophes in the 
assembler language and ampersands in the 
macro language as syntactic characters, the 
following rule must be observed when using 
these characters in a character term. 


For each apostrophe or ampersand desired 
in a character selif-defining term, two 
apostrophes or ampersands must be written. 
For example, the character value A'# would 
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be written as ‘A'‘'#', while an apostrophe 
followed by a blank and another single 
apostrophe would be written as 't' "tt, 


Each character in the character sequence 
is assembled as its eight-bit code equiva- 
lent (see Appendix A). The two apostrophes 
or ampersands that must be used to rep- 
resent an apostrophe or ampersand within 
the character sequence are assembled as an 
apostrophe or ampersand. 


Location Counter Reference 





The Location Counter: A location counter 
is used to assign storage addresses to 
progran statements. It is the assembler's 
equivalent cf the instruction counter in 
the computer. As each machine instruction 
or data area is assembled, the location 
counter is first adjusted to the proper 
boundary for the item, if adjustment is 
necessary, and then incremented by the 
length of the assembled item. Thus, it 
always points to the next available loca- 
tion. If the statement is named by a 
symbol, the value attribute of the symbol 
is the value of the location counter after 
boundary adjustment, but before addition of 
the Length, 





assembler maintains a location 
for each control section of the 

and manipulates each location 
counter as previously described. Source 
statements for each section are assigned 
addresses from the location counter for 
that section. The location counter for 
each successively declared control section 
assigns tocations in consecutively higher 
areas of storage. Thus, if a program has 
multiple control sections, all statements 
identified as belonging to the first con- 
trol section will be assigned from the 
location counter for section 1, the state- 
ments for the second contrel section will 
be assigned from the location counter for 
section 2, etc. This procedure is followed 
whether the statements from different con- 
trol sections are interspersed or written 
in control section sequence. 


The 
counter 
program 


The location counter 
controlled by using the 
assembler instructions, 
in Sections 3 and 5. 
by either of these assemblex instructions 
is the counter for the control section in 
which they appear. The maximum value for 
the location counter is 224-1. 


setting can be 
START and ORG 
which are described 
The counter affected 


The programmer may refer te the current 
value of the location counter at any place 
in a program by using an asterisk as a term 


14 


in an operand. The asterisk represents the 
location of the first byte of currently 
available storage (i.e., after any required 
boundary adjustment). Using an asterisk as 
the operand in a machine-instruction state- 
ment is the same as placing a symbol in the 
name field of the statement and then using 
that symbol as an operand of the statement. 
Because a location counter is maintained 
for each control section, a location count- 
ex reference designates the location count- 
er for the section in which the reference 
appears. 


A reference to the location counter may 


be made in a literal address constant 
(i.e., the asterisk may be used in an 
address constant specified in literal 
form). The address of the instruction 


used for the 
A location 


containing the literal is 
value of the location counter. 


counter reference may not be used ina 
statement which requires the use of a 
predefined symbol, with the exception of 


the EQU and ORG assembler instructions. 


Literals 


A literal term is one of three basic 
ways to introduce data into a program. [It 
is simply a constant preceded by an equal 


sign (=). 


A literal represents data rather than a 
reference to data. The appearance of a 
literal in a statement directs the assem- 
bler program to assemble the data specified 
by the literal, store this data in a 
"literal pool," and place the address of 
the storage field containing the data in 
the operand field of the assembled state- 
ment. 


Literals provide a means of entering 
constants (such as numbers for calculation, 
addresses, indexing factors, or words or 
phrases for printing out a message) into a 
program by specifying the constant in the 
operand of the instruction in wnich it is 
used. This is in contrast to using the DC 
assembler instruction to enter the data 
into the program and then using the name of 
the DC instruction in the operand. Only 
one jiteral is allowed in a machine- 
instruction statement. 


A literal term cannot be combined with 
any other terms. 


A literal cannot be used as the receiv- 
ing field of an instruction that modifies 
storage. 


A literal cannot be specified in a shift 
instruction or an I/O instruction (HIO, HDV, 
TIO, SIO, SIOF). 


4 
4 


When a literal is contained in an in- 
struction, it cannot specify an explicit 
base register or an explicit index register. 


A literal cannot be specified in an ad- 
dress constant (see Section 5, DC--Define 
Constant). 


The instruction 
use of a literal. 


coded below shows one 


[Name joperation Joperand : 
ee {tL jane =F'274" | 
iS Sta ee ne be a Se ee J 

The statement GAMMA is a load instruc- 


tion using a literal as the second operand. 

When assembled, the second operand of the 
instruction will be the address at which 
the value F'274' is stored. 


NOTE: If a literal operand is a self- 
defining term (X,C,B, or decimal) and the 
equal sign (=) is omitted, the statement 
may assemble without error (See "Using 
Self-Defining Terms"). 

In general, literals can be used wherev— 
er a storage address is permitted as an op- 
erand. They cannot, however, be used in 
any assembler instruction that requires the 
use of a previously defined symbol. lLiter- 
als are considered relocatable, because the 
address of the literal, rather than the 
literal itself, will be assembled in the 
statement that employs a literal. The 
assembler generates the literals, collects 
them, and places them in a specific area of 
storage, aS explained in the subsection 
"The Literal Pool." A literal is not to be 
confused with the immediate data in an SI 
instruction. Immediate data is assembled 
into the instruction. 


Literal Format: The assembler requires a 
description of the type of literal being 
specified as well as the literal itself. 
This descriptive information assists the 
assembler in assembling the literal cor- 
rectly. The descriptive portion of the 
literal must indicate the format of the 
constant. It may also specify the length 
of the constant. 


The method of describing and specifying 
a constant as a literal is nearly identical 
to the method of specifying it in the 
operand of a DC assembler instruction. The 
major difference is that the literal must 
start with an equal sign (=), which indi- 


cates to the assembler that a literal 
follows. The reader is referred to the 
discussion of the DC assembler instruction 


operand format (Section 5) for the means of 
specifying a literal. The type of literal 
designated in an instruction is not checked 
for correspondence with the cperation code 
of the instruction. 


Some examples of literals are: 


=A (BETA) -- address constant literal. 

=F'1234' -- a fixed-point number with 
a length of four bytes. 

=C'ABC* -- a character literal. 


The Literal Pool: The literals processed 
by the assembler are collected and placed 
in a special area called the literal pool, 
and the location of the literal, rather 
than the literal itself, is assembled in 
the statement employing a tJliteral. The 
positioning of the literal pool may be 
controlled by the programmer, if he so 
desires. Unless otherwise specified, the 
literal pool is placed at the end of the 
first control section. 


The programmer may 
multiple literal pools be created. Howev- 
er, the sequence in which literals are 
ordered within the pool is controlled by 
the assembler. Further information on 
positioning the literal pool(s) is in Sec- 
tion 5 under "“LTORG--Begin Literai Pool." 


also specify that 


Symbol Length Attribute Reference 


The length attribute of a symbol may be 
used aS a term. Reference to the attribute 
is made by coding L' followed by the 
symbol, as in: 


L' BETA 


The length attribute of BETA will be 
substituted for the term. The following 
example illustrates the use of L'symbol in 
moving a character constant into either the 
high-order or low-order end of a storage 
field. 


For ease in following the 
length attributes of Al 
tioned. However, keep in 


example, the 
and B2 are men- 
mind that the 


L'symbol term makes coding such as this 
possible in situations where lengths are 
unknown. 

Ce oe eae a eh ee Pep Oe 7 
| Name lopeaeion Fomevand { 
<——-——- f= === === foaa—n naan nnn nna 
JAL |Ds |CL8 i 
|B2 {pc |CL2°AB' | 
JHIORD [MVC jA1(L' B2) ,B2 | 
{LOORD [MVC {Ai+L! A1-L'B2(L'B2) B2| 
tee Wt Oe 


Al names a storage field eight bytes in 
length and is assigned a length attribute 
of 8. B2 names a character constant two 
bytes in length and is assigned a length 
attribute of 2. The statement named HIORD 
moves the contents of B2 into the leftmost 
two bytes of Al. The term L'B2 in paren- 
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theses provides the length 
required by the instruction. When the 
instruction is assembled, the length is 
placed in the proper field of the machine 
instruction. 


specification 


The statement named LOORD moves’ the 
contents of B2 into the rightmost two bytes 
of Al. The combination of terms 
A1+L'A1-L'B2 results in the addition of the 
lenqth of Al to the beginning address of 
Al, and the subtraction of the length of B2 
from this value. The result is the address 
of the seventh byte in field Ail. The 
constant represented by B2 is moved into Al 
starting at this address. L'B2 in 
parentheses provides length specification 
as in HIORD. 
Note: As previously stated, the length 
attribute of * is equal to the length of 
the instruction in which it appears, except 
in an ECU to *, in which case the length 
attribute is 1. 


Terms in Parentheses 


Terms in parentheses are reduced to a 
Single value; thus, the terms in parenthe- 
ses, in effect, become a single term. 


Arithmetically combined terms, enclosed 
in parentheses, may be used in combination 
with terms outside the parentheses, as 
follows: 


14+BETA- (GAMMA-LAMBDA) 


When the assembler program encounters 
terms in parentheses in compination with 
other terms, it first reduces the combina- 
tion of terms inside the parentheses to a 
Single value which may be absolute or 
relocatable, depending on the combination 
of terms. This value then is used in 
reducing the rest of the combination to 
another single value. 


Terms in parentheses may be included 
within a set of terms in parentheses: 


A+B~- (C+D- (E+F) +10) 


The innermost set of terms in parenthe- 
ses is evaluated first. Five levels of 
parentheses are allowed; a level of paren- 
theses is a left parenthesis and its cor- 
responding right parenthesis. Parentheses 
which occur aS part of an operand format do 
not count in this limit. An arithmetic 
combination of terms is evaluated as de- 
scribed in the next section “Expressicns." 
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EXPRESSIONS 


This subsection discusses the expres- 


sions used in coding operand entries for 
source statements. Two types of expres- 
sions, absolute and relocatable, are pre- 


sented along with the rules for determining 
these attributes of an expression. 


As shown in Figure 2-3, an expression is 
composed of a single term or an arithmetic 
combination of terms. The following are 
examples of valid expressions: 


* BETA*10 
AREA1+X' 2D' B'101° 

*+32 C'ABC' 

N-25 29 

FIELD+332 L' FIELD 
FIELD LAMBDA+GAMMA 
(EXIT-ENTRY+1) +GO TEN/TWO 
=F'1234' 


ALPHA-BETA/ (10+AREA*L' FIELD) -100 
The rules for coding expressions are: 


1. An expression cannot start with an 
arithmetic operator, ( +-/* ). There- 
fore, the expression -AtBETA is inval- 
id. However, the expression 0O-A+BETA 
is valid. 


2. An expression cannot contain two 
terms or two operators in succession. ‘ 


3. An expression cannot consist of more 
than 16 terms. 

4. An expression cannot have more than 
five levels of parentheses. 


5. A multiterm expression cannot con- 
tain a literal. 


Evaluation of Expressions 


A single—term expression, 
BETA, *, L'SYMBOL, takes on the 
the term involved. 


e.g.-, 29, 
value of 


A multiterm expression, e.g., BETA+10, 
ENTRY-E£EXIT, 25*10+A/B, iS reduced to a 
Single value, as follows: 


1. Each term is evaluated. 


2. Every expression is computed to 32 
bits, and then truncated to the right- 
most 24 bits. 


3. Arithmetic operations are performed fron 
left to right except that multiplicatior 
and division are done before addition 
and subtraction, e.g., A+B*C is evaluate 
as A+(B*C), not (A+B)*C. The computed , 
result is the value of the expression. 


4. Division always yields an integer 
result; any fractional portion of the 
result is dropped. E.g., 1/2410 
yields a zero result, whereas 10*1/2 
yields 5. 


5. Division by zero is permitted and 
yields a zero result. 


Parenthesized multiterm subexpressions 
are processed before the rest of the terms 
in the expression, e.g., in the expression 
A+BETA* (CON-10), the term CON-10 is 
evaluated first and the resulting value is 
used in computing the final value of the 
expression. 


Negative values are carried in 2s 
complement form. Final values of ex- 
pressions are the rightmost 24 bits of 
the results. Intermediate results have 
a range of -231 through 231-1. However, 
the value of an expression before trunca- 
tion must be in the range -224 through 
2 24-1 or the results will be meaningless. 
A negative result is considered to be a 
3-byte positive value. 

NOTE: In A-type address constants, the 
full 32-bit final expression result is 
truncated on the left to fit the specified 
or implied length of the constant. 


Absolute and Relocatable Expressions 


An expression is called absolute if its 
value is unaffected by program relocation. 


An expression is called relocatable if 
its value depends upon program relocation. 


The two types of expressions, absolute 
and relocatable, take on these charac- 
teristics from the term or terms composing 
them. 


Absolute Expression: An absolute expres- 


sion can be an absolute term or any arith- 
metic combination of absolute terms. An 
absolute term can be a non-relocatable 
symbol, any of the self-defining terms, or 
the length attribute reference. As indi- 
cated in Figure 2-3, all arithmetic opera- 
tions are permitted between absolute terms. 


An expression is absolute, even though 
it may contain relocatable terms (RT)-- 
alone or in combination with absolute terms 
(AT) --under the following conditions. 


1. There must be an even number of relo- 
catable terms in the expression. 


2. The relocatable terms must be paired. 
Each pair of terms must have the same 
relocatability, i.e., they appear in 
the same control section in this 


assembly (see Program Sectioning and 
Linking, Section 3). Each pair must 


consist of terms with opposite signs. 
The paired terms do not have to be 
contiguous, e.g., RT+AT-RT. 


3. No relocatable term can enter into a 
multiply or divide operation. Thus, 
RT-RT*10 is invalid. However, 
(RT-RT)*10 is valid. 


The pairing of relocatable terms (with 
opposite signs and the same relocat- 
ability) cancels the effect of reloca- 
tion since both symbols would be relocated 
by the same amount. Therefore the value 
represented by the paired terms remains 
constant, regardless of program relocation. 
For example, in the absolute expression 
A-Y+X, A is an absolute term, and X and Y 
are relocatable terms with the same re- 
locatability. If A equals 50, Y equals 
25, and X equals 10, the value of the 
expression would be 35. If X and Y are 
relocated by a factor of 100 their values 
would then be 125 and 110. However, the 
expression would still evaluate as 35 
(50-125+110=35). 

An absolute expression reduces to a 
Single absolute value. 


The following examples illustrate abso- 
lute expressions. A is an absolute term; X 
and Y are relocatable terms with the same 
relocatability. 


A-Y+X 

A 

A*A 

X-YtA 

*-~Y (a reference to the location counter 
must be paired with another relocata- 
ble term from the same control sec- 
tion, i.e., With the same relocatabil- 
ity) 


Relocatable Expressions: A relocatable 


expression is one whose value changes by 

n if the program in which it appears is 
relocated n bytes away from its originally 
assigned area of storage. All relocatable 
expressions must have a positive value. 


A relocatable expression can be a relo- 
catable term. A relocatable expression can 
contain relocatable terms -- alone or in 
combination with absolute terms -- under 
the following conditions: 


1. There must be an odd number of reloca- 
table terms. 

2. <All the relocatable terms but one must 
be paired. Pairing is described in 
Absolute Expression. 

3. The unpaired term must not be directly 
preceded by a minus sign. 

4. No relocatable term can enter into a 
multiply or divide operation. 
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A relocatable expression 
Single relocatable value. This value is 
the value of the odd relocatable term, 
adjusted by the values represented by the 
absolute terms and/or paired relocatable 
terms associated with it. The relocatabil- 
ity attribute is that of the odd relccata- 
ble term. 


reduces to a 


For example, in the expression W-X+W-10, 
Wand X are relocatable terms with the same 
relocatability attribute. If initially W 
equals 10 and X equals 5, the value of the 
expression is 5. However, upon relocation 
$his value will change. Tf a relocation 
factor of 100 is applied, the value of the 
expression is 105. Note that the value of 
the paired terms, W-X, remains constant at 
5 regardless of relocation. Thus, the new 
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value of the expression, 105, is the result 
of the value of the odd term (W) adjusted 
by the values of W-X and 10. 


The following examples illustrate 
catable expressions. A is an absolute 
term, W and X are relocatable terms with 
the same relocatability attribute, Y is a 
relocatable term with a different relocat-~- 
ability attribute. 


relo- 


Y-324A W-X+* =F'1234' (literal) 
W-X+Y¥ A*A+W-Wt+Y 
* (reference to W-X+W 


location counter) Y 


SECTION 3: 


ADDRESSING 


The IBM System/360 addressing technique 
requires the use of a base register, which 
contains the base address, and a displace- 
ment, which is added to the contents of the 
base register. The programmer may specify 
a symbolic address and request the assem- 
bler to determine its storage address com- 
posed of a base register and a displace- 
ment. The programmer way rely on the 
assembler to perform this service for him 
by indicating which general registers are 
available for assignment and what values 
the assembler may assume each contains. 
The programmer may use as many or as few 
registers for this purpose as he desires. 
The only requirement is that, at the point 
of reference, a register containing an 
address from the same control section is 
available, and that this address is less 
than or equal to the address of the item to 
which the reference is being made. The 
difference between the two addresses may 
not exceed 4095 bytes. 


ADDRESSES -- EXPLICIT AND IMPLIED 


An address is composed of a displacement 


pilus the contents of a base register. (in 
the case of RX instructions, the contents 
of an index register are also used to 


derive the address in the machine.) 


The programmer writes an explicit 
address by specifying the displacement and 
the base register number. In designating 
explicit addresses a base register may not 
be combined with a relocatable symbol. 


He writes an implied address by speci- 
fying an absolute or relocatable address. 
The assembler has the facility to select a 
base register and compute a displacement, 
thereby generating an explicit address from 
an implied address, provided that it has 
been informed (1) what base registers are 
available to it and (2) what each contains. 
The programmer conveys this information to 
the assembler through the USING and DROP 
assembler instructions. 
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ADDRESSING -- PROGRAM SECTIONING AND LINKING 


BASE REGISTER INSTRUCTIONS 


The USING and DROP assembler instruc— 
tions enable programmers to use expressions 
representing implied addresses as operands 
of machine-instruction statements, leaving 
the assignment of base registers and the 


calculation of displacements to the assem- 
bler. 

In order to use symbols in the operand 
field of machine-instruction statements, 


the programmer must (1) indicate to the 
assembler, by means of a USING statement, 
that one or more general registers are 
available for use as base registers, (2) 
specify, by means of the USING statement, 
what value each base register contains, and 
(3) load each base register with the value 
he has specified for it. 


Having the assembler determine base reg- 
isters and displacements relieves the pro- 
grammer of separating each address into a 
displacement value and a base address 
value. This feature of the assembler will 
eliminate a likely source of programming 
errors, thus reducing the time required to 
check out programs. To take advantage of 
this feature, the programmer uses the USING 
and DROP instructions described in this 
subsection. The principal discussion of 
this feature follows the description of 
both instructions. 


USING -- Use Base Address Register 


The USING instruction indicates that one 
or more general registers are available for 
use as base registers. This instruction 
also states the base address values’ that 
the assenbler may assume will be in the 
registers at object time. Note that a 
USING instruction does not load the reg- 
isters specified. It is the programmer's 
responsibility to see that the specified 
base address values are placed into the 
registers. Suggested loading methods are 


described in the subsection "Programming 
with the USING Instruction." A reference 
to any name in a control section cannot 


occur in a machine instruction or an S-type 
address constant before the USING statement 
that makes that name addressable. The 

format of the USINGinstruction statement is: 
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itiame {Operation Joperana | 
bapa tenn anno nn ten nnn nn none { 
| cates | USING |From 2-17 expressions | 
ese a | Jof the form v,r1, 

pers sl [r2,V3,+.-,116 | 
| OF | | | 
Pee a Mie bla eced [Saree eee eee 


Operand v must be an absolute or reloca- 
table expression. It may be a negative 
number whose absolute value does not exceed 
224%, No literals are permitted. Operand v 
specifies a value that the assembler can 
use aS a base address. The other operands 
must be absolute expressions. The operand 
ri specifies the general register that can 
be assumed to contain the base address 
represented by operand v. Operands r2, r3, 
v4, « . .». Specify registers that can be 
assumed to contain v+4096, vt8192, vt+1z288, 


- 7 -, respectively. The values of the 
operands rl, r2, r3, «se, 4¥16 must be 
between 0 and i15. For example, the state- 
ment : 

AEE Te ee oe 7 
| Name [Operation TOperaad | 
p-—-—--— | | ro ac { 
| | USING I* 12,13 | 
ie ee se in ee a i oe Jj 


tells the assembler it may assume that the 
current value of the location counter will 
be in general register 12 at object time, 
and that the current value of the location 
counter, incremented by 4096, will be in 
general register 13 at object time. 


If the programmer changes the value ina 
base register currently being used, and 
wishes the assembler to compute displace- 
ment from this value, the assembler must be 
told the new value by means of another 
USING statement. In the following sequence 
the assembler first assumes that the value 
of ALPHA is in register 9. The second 
statement then causes the assembler to 
assume that ALPHA+1000 is the value in 
register 9. 


| Name Toperakion loperana | 
f---~-- soe pea fanaa ann nnn nnn nnn ---| 
{ | USING | ALPHA, 9 | 
| i- | | 
\ | | 
| |usiNG Pape 00) 9 | 


If ae programmer has to refer to the 
first 4096 bytes of storage, he can use 
general register 0 as a base register sub- 
ject to the following conditions: 


1. The value of operand v must be either 
absolute or relocatable zero or simply 
relocatable, and 
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2. register 0 must be specified as operand 
rl. 


The assembler assumes that register 0 
contains zero. Therefore, regardless of 
the value of operand v, it calculates dis- 
placements as if operand v were absolute 
or relocatable zero. The assembler also 
assumes that subsequent registers specified 
in the same USING statement contain 4096, 
8192, etc. 


NOTE: If register 0 is used as a base 
register, the program is not relocatable, 
despite the fact that operand v may be 
peleeat able: The program can be made re- 
locatable by: 


Ls Replacing register 0 in the USING 
statement. 

2. Loading the new register with a re- 
locatable value. 

3. Reassembling the program. 


DROP _-- Drop Base Register 





The DROP instruction specifies a pre- 
viously available register that may no 
longer be used as a base register. The 


format of the DROP instruction statement is 
as follows: 


[Name [operaenca jOpecand | 
ja ser, [DROP |Up to 16 absolute | 
| 2 bol | Jexpressions of the | 
ieee | |form r1,r2, | 
] | JOB js ete 116 | 
2) 1) a na em AL AUT near Pe 4 

The expressions indicate general reg- 


isters previously named in a USING state- 
ment that are now unavailable for base 
addressing. The following statement, for 
example, prevents the assembler from using 
registers 7 and 11: 


Cape ee a ee ee ee ee 1 
| Name jOperation Joperana | 
[------ $-----------4---------------------- 4 
| | DROP }7,11 | 
Loses dee ea a ee oe Jj 


It is not necessary to use a DROP 
statement when the base address being used 
is changed by a USING statement; nor are 
DROP statements needed at the end of the 
source program. 


A register made unavailable by a DROP 
instruction can be made available again by 
a subsequent USING instruction. 


PROGRAMMING WITH THE USING INSTRUCTION 


The USING (and DROP) instructions may be 
used anywhere in a program, as often as 
needed, to indicate the general registers 


that are available for use as base reg- 
isters and the base address values the 
assembler may assume each contains at ex- 


ecution time. Whenever an address is spec- 
ified in a machine-instruction statement, 
the assembler determines whether there is 
an available register containing a suitable 
base address. A register is considered 
available for a relocatable address if it 
was specified in a USING instruction to 
have a relocatable value. A register with 
an absolute value is available only for 
absolute addresses. In either case, the 
base address is considered suitable only if 
it is less than or equal to the address of 
the item to which the reference is made. 
The difference between the two addresses 
May not exceed 4095 bytes. In calculating 
the base register to be used, the assembler 
will always use the available register 
giving the smallest displacement. If there 
are two registers with the same value, the 
highest numbered register will be chosen. 


fame soe We a ne ae ee a ee 1 
| Name [Operation |Operand | 
p-------4----------- fama a nnn nnn nnn nnn nnn 1 
{BEGIN |BALR {2,0 | 
| [USING \*,2 | 
|FIRST | . | | 
| | - | | 
| |. | | 
|LAST |. | | 
| | END | BEGIN | 
Lone x en eee eee Het oe at ee J 

In the preceding sequence, the BALR 
instruction loads register 2 with the 
address of the first storage location 


immediately following. In this case, it is 
the address of the instruction named FIRST. 
The USING instruction indicates to the 
assembler that register 2 contains this 


fps sSe= Poors See ae ee 
| Name |Operation |Operand 

Se ee 4$--------------------- 
| BEGIN | BALR |2,0 

| | USING |HERE,2,3,4,5 

| HERE | LM |3,5,BASEADDR 

| {B | FIRST 

|BASEADDR |DC | 

| FIRST |- | 

| f | 

| LAST |. | 

| | END | BEGIN 

Ne Peo ee Ee eee ee eee ee 


Figure 3-1. 
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Multiple Base Register Assignment 


location. When employing this method, the 
USING instruction must immediately follow 
the BALR instruction. No other USING or 
load instructions are required if the loca- 
tion named LAST is within 4095 bytes of 
FIRST. 


In Figure 3-1, the BALR and LM instruc- 
tions load registers 2-5. The USING 
instruction indicates to the assembler that 
these registers are available as base reg- 
isters for addressing a maximum of 16,384 
consecutive bytes of storage, beginning 
with the location named HERE. The number 
of addressable bytes may be increased or 
decreased by altering the number of reg- 


isters designated by the USING and LM 
instructions and the number of address 
constants specified in the DC instruction. 


RELATIVE ADDRESSING 


Relative addressing is the technique of 
addressing instructions and data areas by 
designating their location in relation to 
the location counter or to some symbolic 
location. This type of addressing is 
always in bytes, never in bits, words, or 
instructions. Thus, the expression *+4 
specifies an address that is four bytes 
greater than the current value of the 
location counter. In the sequence of 
instructions shown in the following exam- 
ple, the location of the CR machine 
instruction can be expressed in two ways, 


ALPHA+2 or BETA-4, because all of the 
mnemonics in the example are for 2-byte 
instructions in the RR format. 
aa Mie as a oe ee 
{Name JOperation |Operand | 
-------}----------- $---------------------4 
ALPHA |LR 13,4 { 
| [CR (4,6 | 
| | BCR |1,14 | 
{BETA |AR {2,3 | 
ey ee eee ae eased eee J 
ere Sie Pes 3 Sa Pee oe a a aoe 7 
| 
Je ee ee eel es Ba a ts Se 4 


| 
| 
| 
A(HERE+4 096 , HERE+ 8192, HERE+12288) | 
| 
| 
| 
| 
| 
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It is often convenient, or necessary, to 
write a large program in sections. The 
sections may be assembled separately, then 
combined into one object program. The 
assembler provides facilities for creating 
multisectioned programs and symbolically 
linking separately assembled programs or 
program sections. 


Sectioning a program is optional, and 
many programs can best be written without 
sectioning them. The programmer writing an 
unsectioned program need not concern him- 
self with the subsequent discussion of 
program sections, which are called control 
sections. He need not employ the CSECT 
instruction, which is used to identify the 
control sections of a multisection program. 
Similarly, he need not concern himself with 
the discussion of symbolic Linkages if his 
program neither requires a linkage to nor 
receives a linkage from another program. 
He may, however, wish to identify the 
program and/or specify a tentative starting 
location for it, both of which may be done 
by using the START instruction. He may 
also want to employ the cummy section 
feature obtained by using the DSECT 
instruction. 


Note: Program sectioning 
closely related to the specification of 
base registers for each control section. 
Sectioning and linking examples are provid- 
ed under the heading "Addressing External 
Control Sections." 


and linking is 


CONTROL SECTIONS 


The concept of program sectioning is 4 
consideration at coding time, assembly 
time, and load time. To the programmer, a 
program is a logical unit. He may want to 
divide it into sections called control 
sections; if so, he writes it in such a way 
that control passes properly from one sec- 
tion to another regardless of the relative 
physical position of the sections in stor- 
age. A control section is a block of 
coding that can be relocated, independently 
of other coding, at load time without 
altering cr impairing the operating logic 
of the program. It is normaily identified 
by the CSECT instruction. However, if it 
is desired to specify a tentative starting 
location, the START instruction may be used 
to identify the first control section. 


To the assembler, there is no such thing 
as a program; instead, there is an assem- 


bly, which consists of one or more control 
sections. (However, the terms assembly and 
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program are often used interchangeably.) 
An unsectioned program is treated as a 
single control section. To the linkage 
editor, there are no programs, only control 
sections that must be fashioned into a load 
module. 


The output from the assembler is called 
an object module. It contains data re- 
quired for linkage editor processing. The 
external symbol dictionary, which is part 
of the object module, contains information 
the linkage editor needs in order to com- 
plete cross-referencing between control 
sections as it combines them into an object 
program. The linkage editor can take 
control sections from various assemblies 
and combine them properly with the help of 
the corresponding control dictionaries. 
Successful combination of separately 
assembled control sections depends on the 
techniques used to provide symbolic 
linkages between the control sections. 


Whether the programmer writes an unsec~ 
tioned program, a mulitisection program, or 
part of a multisection program, he still 


knows what eventually will be entered into 
storage because he has described storage 
symbolically. He may not know where each 
section appears in storage, but he does 


know what storage contains. There is no 
constant relationship between control sec- 
tions. Thus, knowing the location of one 
control section does not make another con- 
trol section addressable by relative 
addressing techniques. 


The programmer must be aware that there 
is a limit to external symbol dictionary 
entries. The total number of control 
sections, dummy sections, unique symbols 
in EXTRN and WXTRN statements, V-type 
address constants, and external dummy 
sections must not exceed 255. Certain con- 
stants may cause a symbol to be counted 
twice: e.g., external symbols in V-type 
address constants (unless they are expli~ 
citly defined in an EXTRN or WXTRN state- 
ment), and external dummy sections 
implicitly defined by Q-type address 
constants and corresponding DSECT state- 
ments. EXTRN and WXTRN statements are 
described in this section; V-type and 
Q-type constants in Section 5 under 
"Operand Subfield 4: Constant." 


Control Section Location Assignment 


Control 
because the 
counter tor 
tions are 


sections can be intermixed 

assembler provides a location 
each control section. Loca- 
assigned to control sections as 


if the sections are placed in storage 
consecutively, in the same order as they 
first occur in the program. Each control 
section subsequent to the first begins at 
the next available double-word boundary. 


FIRST CONTROL SECTION 


The first control section of a program 
has the following special prcperties: 


1. Its initial location counter value may 
be specified as an absolute value, if 
the START instruction is used. 


2. It contains the literals of the program, 


unless their positioning has been altered 


by LTORG statements, 


START -- Start Assembly 


used to 
control 


The START instruction may be 
give a name to the first (or only) 
section of a program. It may also be used 
to specify an initial location counter 
value for the first control section of the 
program. The format of the START instruc- 
tion statement is as follows: 


[eto rao, 5 Paani ie eae SS 1 
| Name [Operation |Operand | 
~--------~ }-----------}------------------] 
Any | START |A self-defining | 
| symbol | |term, or blank | 
Jor blank {| | | 
ie ey Ler SS See Sa doseeetoseslese sees J. 


If a symbol names the START instruction, 
the symbol is established as the name of 
the control section. If not, the control 
section is considered to be unnamed. All 
subsequent statements are assembled as part 
of that control section. This continues 
until a CSECT instruction identifying a 
different control section or a DSECT 
instruction is encountered. A CSECT 
instruction named by the same symbol that 
names a START instruction is considered to 
identify the continuation of the control 
section first identified by the START. 
Similarly, an unnamed CSECT that occurs in 
a program initiated by an unnamed START is 
considered to identify the continuation of 
the unnamed control section. 


The symbol in the name field is a valid 


relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attribute 
of i. 


Section 3: 


The assembler uses the self-defining 
term specified by the operand as the ini- 
tial location counter value of the program. 
This value should be divisible by eight. 
For example, either of the following state- 
ments could be used to assign the name 
PROG2 to the first control section and to 
indicate an initial assembly location coun- 
ter value of 2040. If the operand is omit- 
ted, the assembler sets the initial location 
counter value of the program at zero. The 
location counter is set at the next double- 
word boundary when the value of the START 
operand is not divisible by eight. 


nea Toe Sia el eee ee 1 
| Name JOperation |Operand | 
~------ f-----------4---------------------| 
|PROG2 |START | 2040 | 
|PROG2 |START |X'7F8' | 
Loe Sos det BS Ms Se ee i 


Note:The START instruction must not be 
preceded by any code that will cause an 
unnamedccontrol section to be assembled. 
(See "Unnamed First Control Section" 
below.) 





CSECT -- Identify Control Section 


The CSECT instruction identifies the 
beginning or the continuation of a control 
section. The format of the CSECT instruc- 
tion statement is as follows: 


age aa Too eee To ee q 
| Name [Operation |Operand | 
f-~--------4--~+-----+---4---+-----------+---- 
{Any | CSECT |Not used; should | 
[symbol | | be blank | 
lor blank | } 4 
tip eels docentaceols Paso bes eos eee heey 4 


If a symbol names the CSECT instruction, 
the symbol is established as the name of 
the control section; otherwise the section 
is considered to be unnamed. All state- 
ments following the CSECT are assembled as 
part of that control section until a state- 
ment identifying a different control sec- 
tion is encountered (i.e., another CSECT or 
a DSECT instruction). 


The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attrioute 
of 1. 


Several CSECT statements with the same 
name may appear within a program. The 
first is considered to identify the begin- 
ning of the control section; the rest 
identify the resumption of the section. 
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Thus, statements from different control 
sections may be interspersed. Tney are 
properly assembled (assigned contiguous 
storage locations) as long as the State- 
ments tron the various control sections are 
identified by the appropriate CSECT 
instructions. 


Unnamed First Control Secticn 


All macnine instructions and many assem- 
bler instructions have to belong to a con- 
trol section. If such an instruction pre- 
cedes the first CSECT instruction, the 
assembler will consider it to belong to an 
unnamed control section (also referred to 
as private code), which will be the first 
(or only) control section in the module. 


The following instructions will not 
cause this to happen, since they do not 
have to belong to a control section: 


Common Control Sections 

Dummy Control Sections 

Macro Definitions 

Conditional Assembly Instructions 
Comments 

COPY (depends on the copied code) 
DXD 

EJECT 

ENTRY 

EXTRN 

IctTh 

ISEQ 

OPSYN 

PRINT 

PUNCH 

REPRO 

SPACE 

TITLE 

WXTRN 


No other assembler or machine instructions 
since START, 


can precede a START instruction, 
if used, must initiate the first control 
section in the program. 


An invcluntary unnamed control section 
at the beginning can cause trouble if 
literals are used. Then the programmer must 
be aware cf the fact, that unless he codes 
an LTORG statement in each control section 
where he uses literals, literals will be 
assembled in the first control section, 
which will in this case be the involuntary 
section. If that control section does not 
establish addressability (through USING), 
an addressability error will be the result. 
Therefore statements like EQU should not 
be placed before the first CSECT or the 
START instruction. 


Resumption of an unnamed control section 
at later points can be accomplished through 
unnamed CSECT statements. A program can 
contain only one unnamed control section. 
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Of course, it is possible to write a pro- 
gram that does not contain CSECT or START 
statements. It will then be assembled as 
one unnamed control section. 


DSECT -- Identify Dummy Section 


A dummy section represents a control 
section that is assembled put is not part 
of the object program. A dummy section is 
a convenient means of describing the layout 
of an area of storage without actually 
reserving the storage. (It is assumed that 


the storage is reserved either by some 
other part of this assembly or else by 
another assembly.) The DSECT instruction 


identifies the beginning or resumption of a 
dummy section. More than one dummy section 
may be defined per assembly, but each must 
be named. The format ot the DSECT instruc- 
tion statement is as follows: 


Name Operation Operand 

vari- DSECT Not used; shoul 
able symbol be blank 
ior ordinary 
symbol 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the first pyte of the section. It has a 


length attribute of 1. 


Program statements belonging to dumny 
sections may be interspersed throughout the 
program or may be written as a unit. In 
either case, the appropriate DSECT instruc- 
tion should precede each set of statements. 


When multiple DSECT instructions with the 
same name are encountered, the first is 
considered to initiate the dummy section 


All assembler 
occur within 


and the rest to continue it. 
language instructions may 
dummy sections. 


Symbois that name statements in a dummy 
section may be used in USING instructions. 
Therefore, they may be used in program 
elements (e.g., machine-instructions and 
data definitions) that specify storage 
addresses. An example illustrating the use 
of a dummy section appears subsequently 
under “Addressing Dummy Sections." 


e: A symbol that names a statement ina 
dummy section may be used in an A-type 
address constant only if it is paired with 
another symbol (with the cpposite sign) 
from the same dummy section. 


4 


DUMMY SECTION LOCATION ASSIGNMENT: A loca- 
tion counter is used to determine the 
relative locations of named program ele- 
ments ina dummy section. The location 
counter is always set to zero at the 
beginning of the dummy section, and the 
location values assigned to symbols that 
name statements in the dummy section are 
relative to the initial statement in the 
section. 


ADDRESSING DUMMY SECTIONS: The programmer 
may wish to describe the format of an area 
whose storage location will not be deter- 
mined until the program is executed. He 
can describe the format of the area in a 
dummy section, and he can use symbols 
defined in the dummy section as the oper- 
ands of machine instructions. To effect 
references to the storage area, he does the 
following: 


1. Provides a USING statement specifying 
both a general register that the 
assembler can assign to the machine- 
instructions as a base register and a 


Section 3: 


value from the dummy section that the 
assembler may assume the register con- 
tains. 


2. Ensures that the same register is 
loaded with the actual address of the 
Storage area. 

The values assigned to symbols defined 
in a dummy section are relative to the 
initial statement of the section. Thus, 
all machine-instructions which refer to 


names defined in the dummy section will, at 
execution time, refer to storage locations 


relative to the address loaded into the 
register. 
An example is Shown in the following 


coding. Assume that two independent assem- 
blies (assembly 1 and assembly 2) have been 
loaded and are to be executed as a Single 
overall program. Assembly 1 is an input 
routine that places a record in a specified 
area of storage, places the address of the 
input area containing the record in general 
register 3, and branches to assembly 2. 


Assembly 2 processes the record. The cod- 
ing shown in the example is from assembly 
2. 

24.1 
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The input area is described in assembly 
2 by the DSECT control section named INAR- 
EA. Portions of the input area (i.e., 
record) that the programmer wishes to work 
with are named in the DSECT control section 
as shown. The assembler instruction USING 
INAREA,3 designates general register 3 as 
the base register to be used in addressing 
the DSECT control section, and that general 
register 3 is assumed to contain the 
address of INAREA. 


Assembly 1, during execution, loads the 
actual beginning address of the input area 
in general register 3. Because the symbols 
used in the DSECT section are defined 
relative to the initial statement in the 
section, the address values they represent, 


will, at the time of program execution, be 
the actual storage locations of the input 
area. 

arene a acd To te Tern ee 7 
| Name |Operation |Operand : 
anno} -- +--+} ------- --- -- -- + = 

|ASMBLY2 |CSECT | \ 
| BEGIN { BALR {2,0 | 
{ | USING [*,2 | 
| ae | | 
| [8 | | 
| | USING | INAREA, 3 | 
| {CLI {INCODE,C'A' { 
| {BE { ATYPE | 
| —_— | | 
| |. | | 
| ATYPE juve | WORKA, INPUTA | 
| jMvc | WORKB, INPUTB | 
| fs | | 
l | - | | 
|WORKA |Ds | CL20 | 
| WORKB {Ds {CL18 | 
| | - | | 
| = | | 
JINAREA  {|DSECT | | 
| INCODE {Ds | CLL | 
| INPUTA [Ds | CL20 | 
| INPUTB jps jcLis | 
| |. | | 
| J END | | 
bese oS Boob ss se lune: eee ee SS J 


The programmer must ensure that a section 
of code in his program is actually described 
by the dummy section which references it. 
Consider the following example, which 
illustrates how a dummy section should not 
be addressed: 


Section 3: 


ame Operation Operand 
EST CSECT 

CNOP 2,4 
ALF DS CL2 
ULL DS F 

END 
REA DSECT 
ALF DS CL2 
ULL DS F 





Note that in the dummy section AREA, two 
bytes are skipped between HALF and FULL in 
order to align FULL on a fullword boundary. 
In the control section TEST, however, the 
CNOP instruction causes two bytes to be 
skipped. Thus FULL is properly aligned with- 
out skipping any bytes between HALF and 
FULL. 

When the programmer addresses the dumny 
section, the location of FULL (relative to 
the location of HALF) will not be the same 
as the location of FULL in the control 
section. 


Note: To correct this example change the 
CNOP instruction to CNOP 0,4. 





EXTERNAL DUMMY SECTIONS (ASSEMBLER F ONLY) 


External dummy sections facilitate com- 
munication between programs by allowing the 
programmer to define work areas in several 
different programs and then at execution to 
combine them into one block of storage 
accessible to each program. Several dif- 
ferent programs may be assembled together, 
each with one or more external dummy sec- 
tions and after the linkage editor process- 
es these programs, the programmer cal allo- 
cate storage for the dummy sections in one 
block. External dummy sections are defined 
through the use of the DXD instruction or a 
DSECT in combination with a O-type DCIin- 
struction. In order to allocate the cor- 
rect amount of storage when the program is 
executed, the programmer must use the CxXD 
instruction, described below, within one 
of the programs. 


DXD ~~ DEFINE EXTERNAL DUMMY SECTION 


The DXD instruction (also referred to 
as a Pseudo Register) defines an external 


dummy section; when the assembler encoun- 
ters a DXD instruction, it computes the 
amount of storage required and the align- 


ment and passes this information to the 
linkage editor which will compute the total 


length of the external dummy sections. The 
format for the DXD instruction is: 
Addressing -- Program Sectioning and Linking 25 


} + 
{A symboi|DXD |Duplication factor, | 
| | |type, length, constant] 


Bi ata Ser Sn ae as a ee dn tae spa ci” im nn ot do nin 


in the name field is a symbol 
Q-type constant 


The symbol 
that usually appears as a 
in the operand field of a DC statement 
later in the program. It has a length 
attribute of 1. The operand form and 
alignment are the same as that described 
for the DS instruction. If more than one 
external dummy section with the same name 
is encountered by the linkage editor, it 
uses the largest section in computing total 
length; if two or more identically named 
external dummy sections have different 
boundary alignments, the linkage editor 
uses the most restrictive alignment in 
computing total length. An external dummy 
section is generated by a Q-type address 
constant which references a DSECT name. 


CXD - CUMULATIVE LENGTH EXTERNAL DUMMY 
SECTION 


The CXD instruction allocates a four-byte 
full-word aligned area in storage which will 
contain the sum of the lengths of all ex- 
ternal dummy sections when the program is 
executed. This sum is supplied by the link- 
age editor. The instruction format is: 


(es es te a Ie Ee ee i ee | 
| Name |Operation| Operand 

}-----------------4---------4------------~- 
j Any symbol or |CXD |Must be blank| 
ecoas ea aNCeenreny eee ene ane ee 


The CXD instruction may appear anywhere 
within a program, or if several programs 
are being combined, it may appear in each 
program. The symbol in the name field 
has a length attribute of 4. 


The following example shows how external 
dummy sections may ve used. 


ROUTINE A 
Pe ee Re Se eee 
| Name | Operation |Operand | 
pac ew ae a att a3 + f+ +4 
[ALPHA | DxD | 2DL8 | 
| BETA | DXD | 4FL4 | 
JOMEGA {| CxD | | 
| 2 | | 

‘ I 
| JDc | Q( ALPHA) 
{ |pc |Q (BETA) | 
| | - | | 
{ | - | i 
Geb aes a es Me ci a a Fe a sce ice tncmelSaic o 4 
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ROUTINE B 


PTS tase pa a aca we ae Cia ae nS 1 
| Name [Operation loperana : 
}----------~4---+-+---------4-------------- 
| GAMMA | DXD J5D | 
| DELTA | DXD |10F | 
| E | | 
| 
| {pc |Q (GAMMA) | 
| [DC | Q (DELTA) I 
I | + | | 
| | - | | 
boa ae ct ee De Re a 4 
ROUTINE C 
Pe ee oa Tos ee Tec TGn ee 4 
| Name | Operation | Operand | 
p----------- focne nnn nnn fon—-—==--~--=- : 
| EPSILON | DXD | 4H | 
| fe | | 
: | 
| {DC | Q(EPSILON) | 
| | - | | 
| | - | | 
eae poe eee mere Ba eee ee ener beeen a eee J 


Sach of the three routines is requesting an 
amount of work area. Routine A wants 2 
double words and 4 full words. Routine B 
wants 5 double words and 10 full words. 
Routine C wants 4 half words. At the time 
these routines are brought into storage the 
sum of the individual lengths will be 
placed in the location of the CXD 
instruction labeled OMEGA. Routine A can 
then allocate the amount of storage that is 
specified in the CXD location. 


COM -- DEFINE BLANK COMMON CONTROL SECTION 


The COM assembler instruction identifies 
and reserves a common area of storage that 
may be referred to by independent assem- 
blies that have been linked and loaded for 
execution as one overall program. 


_ Appearances of a COM statement after the 
initial one indicate the resumption of the 
blank common control section. 


When several assemblies are loaded, 
designating a common control 


each 
section, the 


amount of storage reserved is equal to the 
longest common control section. The format 
is: 

a ear eas [a en Ae Bie a ee eee ae 7 
| Name jOperation ; Operand ! 
Pests cata t ne a eR TOOTS SS estes slsSsesS 4 
| A se- fo | Blank | 
| quence | u 
| symbol set | | 
| blank | | | 
becca see eae ace eran Pretec et | 


The common area may be broken up into 
subfields through use of the DS and DC 
assembler instructions. Names of subfields 
are defined relative to the beginning of 


the common section, as in the DSECT control 


section. 


It is necessary to establish address- 
ability relative to a named statement with- 
in COM since the COM statement itself can- 
not have a name. In the following example, 
addressability to the common area of stor- 
age is established relative to the named 
statement XYZ. 


2 
ra) 
3 
oO 


! 1 
Operation Operand 
eae oe oe aE ewe week, Be eel eee nd aS 1 
| ! ] ! 
! d i] ' 
| 1 * l 1 
| 1 I 1 
| i : I l 
1 H L H 1,=A (XYZ) H 
1 i USING 1 X¥Z,1 t 
' ' mvc | PDQ(16),=4c'aABcD' | 
t 
| | * ] ! 
{| COM 
| XYZ | DS | 16F ! 
| PDQ DS H 16C | 
t 1 ba i} I 
1 — ! i 
f I 4 i 
[ocr od li oe een oI Soo seen een ! 
No instructions or constants appearing 


in a common control section are assembled. 
Data can only be placed in a common control 
section through execution of the program. 
A blank common control section may include 
any assembler language instructions. 


If the assignment of common storage is 
done in the same manner by each independent 
assembly, reference to a location in common 
by any assembly results in the same loca- 
tion being referenced. When the blank 
common control section is assembled, the 
initial value of the location counter is 
set to zero. 


SYMBOLIC LINKAGES 


Symbols may be defined in one module 
and referred to in another, thus effecting 
symbolic linkages between independently 
assembled program sections. The linkages 
can be effected only if the assembler is 
able to provide information about the 
linkage symbols to the linkage editor, 
which resolves these linkage references at 
load time. The assembler places the 
necessary information in the external 
symbol dictionary on the basis of the 
linkage symbols identified by e.g., the 
ENTRY and EXTRN instructions. Note that 
these symbolic linkages are described as 
linkages between independent modules; 
more specifically, they are linkages 
between independently assembled control 
sections. 


Section 3: 
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In the module where the linkage symbol 
is defined (i.e., used as a name), it must 
also be identified to the assembler by 
means of the ENTRY assembler instruction 
unless the symbol is the name of a CSECT 
or START statement. It is identified as 
a symbol that names an entry point, which 
means that another module may use that 
symbol in order to effect a branch op- 
eration or a data reference. The assembler 
places this information in the control 
dictionary. 

Similarly, the module that uses a sym- 
bol defined in some other module must 
identify it by the EXTRN or WXTRN assembler 
instruction. It is identified as an 
externally defined symbol (i.e., defined in 
another module) that is used to effect 
linkage to the point of definition. The 
assembler places this information in the 
external symbol dictionary. 


Another way to obtain symbolic linkages, 
is by using the V-type address constant. 
The subsection "Data Definition 
Instructions” in Section 5 contains the 
details pertinent to writing a V-type 
address constant. It is sufficient here to 
note that this constant may be considered 
an indirect linkage point. It is created 
from an externally defined symbol, but that 
symbol does not have to be identified by an 
EXTRN or WXTRN statement. The V-type 
address constant may be used for external 
branch references (i.e., for effecting 
branches to other programs). It may not be 
used for external data references (i.e., 
for referring to data in other programs). 


ENTRY -- IDENTIFY ENTRY-POINT SYMBOL 


The ENTRY instruction identifies linkage 
symbols that are defined in one source 
module and referenced by other modules. 


 poiepeaeaed ToCTAT SIRT Tosa Se ee a a 
| Name {Operation |Operand i 
t------- a aaa 
|A se- |ENTRY [One or more reloca- | 
| quence | [table symbols, | 
| symbol | |separated by | 
| or | |commas, that also | 
| blank | Jappear as state- I 
| l Jment names | 
tesco oe pee eee de oe eS J 


A source module may contain a maximum of 
100 ENTRY symbols. ENTRY symbols which are 
not defined (not appearing as statement 
names), although invalid, will also count 
towards this maximum of 100 ENTRY symbols. 

The symbols in the ENTRY operand field 
may be used as operands by other programs. 
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An ENTRY statement operand may not contain 
a symbol defined in a dummy section or in 
a blank common control section. The fol- 
lowing example identifies the statements 
named SINE and COSINE as entry points to 
the program. 


| eas Tee ee iy aaa at 1 
{Name [Operation |Operand | 
f------- foann nn ane 4--------~--------~--- : 
| | ENTRY {SINE,CCSIN# | 
| esa bet cheers Ale ner ane Mote SS he a J 
Note: Labels of START and CSECT statements 





are automatically treated as entry points 
to a module. Thus they need not be ident- 
ified by ENTRY statements. 


EXTRN ~- IDENTIFY EXTERNAL SYMBOL 


The EXTRN instruction identifies linkage 


symbols used by one source module but identi- 
Each external symbol 


fied in another module. 
must be identified. This includes symbols 
that refer to control section names. The 
format of the EXTRN statement is: 


z 
3) 
5 
© 
2) 
ue) 
® 
Ss 
3 
Qu 


One or more relocatable 
symbols, separated by 
commas 


A se- 
quence 
symbol 


i 
“a 
Ho 
wm i 
24 
\ 
I 
i 
1 
t 
pose etoec eps 
{ 
! 
{ 
| 
! 
! 
I 
i} 
1 
i 
1 
1 
1 
I 
i 
i 
' 
i 
1 
i 
i 
t 


The 
appear 
module 
length 
is l. 

The 
external symbols. 


symbols in the operand field may not 
as the name of statements in the 
where the EXTRN statement is. The 
attribute of an external symbol 


following example identifies three 
They are used as operands 


in the module where they appear, but they 
are defined in some other module. 
aN ia Ne Se ce a ts ee fs 
|Name joneraeton Topevand | 
}-----~- $----------- }-~-----~------------- : 
| | EXTRN | RATEBL, PAYCALC | 
j [EetaN A EEHCRTS | 
leiseo See Ps ok eee ee eo 4 
An example that employs the EXTRN 
instruction appears subsequently under 


"Addressirg External Controi Sections." 


Note 1: A V-type address constant does 
not have to be identified by an EXTRN state- 
ment. 





Note 2: When external symbols are used in 
an expression they may not be paired. Each 
external symbol must be considered as having 
a unique relocatability attribute. 


28 


Addressing External Control Sections 


A common way for a program to link to an 
external control section is to: 


1. Create a V-type address constant with 
the name of the external symbol. 


2. Load the constant into a general reg- 
ister and branch to the control sec- 
tion via the register. 


For example, to link to the control 
section named SINE, the preceding coding 
might be used. 
foto pe ee eee Ta yg 1 
| Name [Operation |Operand | 

~~-~--~~--~}~--~------- f------------------| 

|MAINPROG |CSECT | | 
| BEGIN | BALR [2,0 | 
| | USING {*,2 | 
| 1 | | 
| ls | | 
| {L |3,VCON | 
| | BALR {1,3 | 
{ | | | 
| ) | | 
| VCON jpc {V(SINE) | 
| | END [BEGIN { 
boveee sees dite et oe Darr ee eS J 

An external symbol naming data may be 


referred to as follows: 


1. Identify the external symbol with the 


EXTRN instruction, and create an 
address constant from the symbol. 
2. Load the constant into a general reg- 


ister, and use the register for base 
addressing. 

For example, to use an area named 

RATETBL, which is in another control sec- 


tion, the following coding might be used: 


(Soe eee a Go ee 1 
| Name operation |Operand | 
~~--------}----------- foa----==----------4 
|MAINPROG |CSECT | | 
| BEGIN | BALR 2,0 | 
I | USING |*,2 | 
| — | | 
| | - I | 
| [EXTRN {| RATETBL | 
\ | - | | 
i | - | | 
| [L |4,RATEADDR | 
| | USING {RATETBL, 4 | 
| JA [3,RATETBL | 
| —_ | | 
| | - | | 
[RATEADDR |DC |A CRATETBL) | 
| | END fete | 
Dies eh Miata thn Se See ea BSS seas J 


The total number of control sections, 
dummy sections, external symbols and exter- 
nal dummy sections must not exceed 255. 


Certain constants may cause a symbol to be 
counted twice: external symbols in V-type 
address constants (unless they are expli- 


citly defined in an EXTRN or WXTRN state- 
ment), and external dummy sections im- 
plicitly defined by Q-type address constants 
and corresponding DSECT statements. (EXTRN 
and WXTRN statements are discussed in this 
section; V-type constants in Section 5 

under the DC assembler instruction.) 


WXTRN -- IDENTIFY WEAK EXTERNAL SYMBOL 


The WXTRN statement has the same format as 
the EXTRN statement. It is used to identify 
weak external references. The only differ- 
ence between a weak (WXTRN) and a strong 
(EXTRN or V-type constant) external refer- 
ence is that the automatic library call 
mechanism of the linkage editor or loader 

is not effective for symbols that are identi- 
fied in WXTRN statements. 


The automatic library call mechanism 
searches the call library for any unresolved 
external references. If it finds any of 
these references, it includes the module 
where the reference occurs in the load 
module produced by the linkage editor or 
loader. Refer to IBM System/360 Operating 
System: Linkage Editor and Loader, GC28-6538 
for a full description of the automatic 
library call mechanism. 

The format of the WXTRN instruction is: 


ne ee a a a a a ee i a a er eee 


1 
Operation | Operand ; 
1 
Ise es Boe ieesl eS Ws oe ee ot ee 
{ \ 
i A se- 1 WXTRN 1;One or more relocatable} 
| quence | ;Symbols, separated by |! 
' symbol : | commas 
1 or 1 ] ' 
| blank | ! 
I I 1 i 
ae een er ag OR 
Note: If a V-type address constant is 


identified by a WXTRN instruction, the 
automatic library call mechanism is 
suppressed for it. 


28.1 


This section discusses the coding of the 
machine-instructions represented in the 
assembler language. The reader is reminded 
that the functions of each machine- 
instruction are discussed in the principles 
of operation manual (see Preface). 


MACHINE-INSTRUCTION STATEMENTS 


Machine-instructions may be 
symbolically as assembler 
statements. The symbolic 


represented 
language 
format of each 


varies according to the actual machine- 
instruction format, of which there are 
five: RR, RX, RS, SI, and SS. Within each 
basic format, further variations are 
possible. 

The symbolic format of a machine- 
instruction is Similar to, but does not 
duplicate, its actual format. Appendix C 


illustrates machine format for the five 
classes of instructions. A mnemonic opera- 
tion code is written in the operation 


field, and one or more operands are written 
in the operand field. Comments may be 
appended to a machine-instruction statement 
as previously explained in Section 1. 


Any machine-instruction statement may be 
named by a symbol, which other assembler 
Statements can use aS an operand. The 
value attribute of the symbol is the 
address of the leftmost byte assigned to 
the assembled instruction. The length 
attribute of the symbol depends on the 
basic instruction format, as follows: 


Basic Format 
RR 
RX 
RS 
SI 
Ss 


Length Attribute 


Arr EN 


Instruction Alignment and Checking 





All machine-instructions are aligned 
automatically by the assembler on half-word 
boundaries. If any statement that causes 
information to be assembled requires align- 
ment, the bytes skipped are filled with 
hexadecimal zeros. All expressions that 
specify storage addresses are checked to 
ensure that they refer to appropriate 
boundaries for the instructions in which 
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they are used. Register numbers are also 
checked to make sure that they specify the 
proper registers, as follows: 


1. Floating-point instructions must spec- 
ify floating-point registers 0, 2, 4, 
or 6. 


2. Double-shift, fulil-word multiply, and 
divide instructions must specify an 
even-numbered general register in the 
first operand. 


OPERAND FIELDS AND SUBFIELDS 


Some symbolic operands are written as a 
single field, and other operands are writ- 
ten as a field followed by one or two 
subfields. For example, addresses consist 
of the contents of a base register and a 
displacement. An operand that specifies a 
base and displacement is written as a 
displacement field followed by a base reg- 
ister subfield, as follows: 40(5). In the 
RX format, both an index register subfield 
and a base register subfield are written as 
follows: 40(3,5). In the SS format, both a 
length subfield and a base register sub- 
field are written as follows: 40(21,5). 


Appendix C shows two types of addressing 
formats for RX, RS, SI, and SS instruc- 
tions. In each case, the first type shows 
the method of specifying an address expli- 
citly, as a base register and displacement. 
The second type indicates how to specify an 
implied address as an expression. 


For example, a load multiple instruction 
(RS format) may have either of the follow- 
ing symbolic operands: 


R1,R3,D2(B2) - - 
R1,R3,S2 aS 


explicit address 
implied address 


Whereas D2 and B2 must be represented by 
absolute expressions, S2 may be represented 
either by a relocatable or an absolute 
expression. 


In order to use implied addresses, the 
following rules must be observed: 


1. The base register assembler instruc- 
tions (USING and DROP) must be used. 


2. An explicit base register 
must not accompany 
address. 


designation 
the implied 
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For example, assume that FIELD is a 
relocatable symbol, which has been assigned 


a value of 7400. Assume also that the 
assembler has peen notified (by a _ USING 
instruction) that general register 12 cur- 


rently contains a relocatable value of 4096 


and is available as a base register. The 
following example shows a machine- 
instruction statement as it would be 


written in assembler language and as it 
would be assembled. Note that the value of 
D2 is the difference between 7400 and 4096 
and that X2 is assembled as zero, since it 
waS omitted. The assembled instruction is 
presented in hexadecimal: 


Assembler statement: 
st 4,FIELD 
Assembled instruction: 


Op.Code Ril X2 B2 D2 
50 4 0 Cc CE8 


An address may be specified explicitly 
as a base register and displacement (and 
index register for RX instructions) by the 
formats shown in the first column of Table 
4-1. The address may be specified as an 
implied adaress by the formats shown in the 
second column. Observe that the two stor- 
age addresses required by the SS instruc- 
tions are presented separateiy; an implied 
address may be used for one, while an 
explicit address is used for the other. 


Table 4-1. Address Specification Details 
oer aes Torr a te ae TSS Se SS Sa 1 


| Type |Explicit Address| Implied Address | 

f-~--—- f-~-------------- $-~--~------------ 1 

| RX | D2 (X2,B2) | S2(X2) | 

{ |D2(,B2) | s2 | 

| RS [D2 (B2) | $2 

| si [D1 (B81) [| s1 | 

| ss {D1 (L1,B1) | s1(Z1) 

| {D1 (L,B1) | sii) 

| [D2(L2,B2) | $2(L2) 

Cones ios hereto ot a ae Pe Soe B ee J 
A comma must separate operands. Paren- 

theses must enclose a subfield or sub- 

fields, and a comma must separate two 


subfields within parentheses. When paren- 
theses are used to enclose one subfield, 
and the subfield is omitted, the parenthe- 
ses must be omitted. In the case of two 
subfields that are separated by a comma and 
enclosed by parentheses, the following 
rules apply: 


1. If both subfields are omitted, the 
separating comma and the parentheses 
must also be omitted. 


L 2,48(4,5) 


L 2,FIELD (implied address) 
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2. If the first subfield in the sequence 
is omitted, the comma that separates 
it from the second subfield is writ- 
ten. The parentheses must also be 
written. 


MVC 32(16,5),FIELD2 
MVC 32(,5),FIELD2 (implied length) 


3. If the second subfield in the sequence 


is omitted, the comma that separates 

it from the first subfield must be 

omitted. The parentheses must be 

written. 

MVC 32(16,5),FIELD2 

MVC FIELD1(16),FIELD2 (implied 
address) 


Fields and subfields in a symbolic oper- 
and may be represented either by absolute 
or by relocatable expressions, depending on 
what the field requires. (An expression 
has been defined as consisting of one term 
or a series of arithmetically combined 
terms.) Refer to Appendix C for a detailed 
description of field requirements. 


Note: Blanks may not appear in an operand 
unless provided by a character self- 
defining term or a character literal. 
Thus, blanks may not intervene between 
fields and the comma separators, between 
parentheses and fields, etc. 

LENGTHS -- EXPLICIT AND IMPLIED 


The length field in SS instructions can 
be explicit or implied. To imply a length, 
the programmer omits a length field from 
the operand. The omission indicates that 
the length field is either of the 
following: 


1. The length attribute of the expression 
specifying the displacement, if an 
explicit base and displacement have 
been written. 


2. The length attribute of the expression 
specifying the effective address, if 
the base and displacement have been 
implied. 


In either case, the length attribute for 
an expression is the length of the leftmost 
term in the expression. The value of L'* 


is the length of the instruction in all 
non-literal machine instruction operands 
and in the CCW assembler instruction. In 


all other uses its value will be 1. 


By contrast, an explicit length is writ- 
ten by the programmer in the operand as an 
absolute expression. The explicit length 
overrides any implied length. 


Whether the length is explicit or 
implied, it is always an effective length. 
The value inserted into the length field of 
the assembled instruction is one less than 
the effective length in the machine- 
instruction statement. 


Note: If ia 
desired, 
or one. 


length field of zero is 
the length may be stated as zero 





To summarize, the length required in an 
SS instruction may be specified explicitly 
by the formats shown in the first column of 
Table 4-2 or may be implied by the formats 
shown in the second column. Observe that 
the two lengths required in one of the SS 
instruction formats are presented separate- 
ly. An implied length may be used for one, 
while an explicit length is used for the 


other. 
Table 4-2. Details of Length Specification 
in SS Instructions 

Go ee en ey ee 1 
| Explicit Length | Implied Length | 
}---~-----~-------}------------=---------- : 
| DICL1,B1) | D1(,B1) | 
| $1(11) | s2 | 
| D1(L,B1) | D1i(,B1) i 
| S1(L) j st | 
{| D2(L2,B2) | D2¢,B2) | 
| S2(L2) | S2 | 
bos este eee Ses Ne Sn ee ey ae J 


MACHINE- INSTRUCTION MNEMONIC CODES 


The mnemonic operation codes (shown in 
Appendix D) are designed to be easily 
remembered codes that indicate the func- 
tions of the instructions. The normal 
format of the code is shown below; the 
items in brackets are not necessarily pre- 
sent in ail codes: 

Verb[Modifier] [Data Type] [Machine Format] 

The verb, which is usually one or two 
characters, specifies the function. For 
example, A represents Add , and MV rep- 
resents Move. The function may be further 
defined by a modifier. For example, the 
modifier L indicates a logical function, as 
in AL for Add Logical. 


Mnemonic codes for functions involving 
data usually indicate the data types by 
letters that correspond tc those for the 


data types in the DC assembler instruction 
(see Section 5). Furthermore, letters U 
and W have been added to indicate short and 
long, unnormalized floating-point opera- 
tions, respectively. For example, AE indi- 
cates Add Normalized Short, whereas AU 
indicates Add Unnormalized Short. Where 
applicable, full-word fixed-point data is 
implied if the data type is omitted. 


The letters Rand I are 
codes 
machine 


added to the 
to indicate, respectively, RR and SI 
instruction formats. Thus, AER 
indicates Add Normalized Short in the RR 
format. Functions involving character and 
decimal data types imply the SS format. 


MACHINE-INSTRUCTION EXAMPLES 


The examples that follow are grouped 
according to machine-instruction format. 
They illustrate the various symbolic oper- 
and formats. All symbols employed in the 
examples must be assumed to be defined 
elsewhere in the same assembly. All sym- 
bols that specify register numbers and 
lengths must be assumed to be equated 
elsewhere to absolute values. 


Implied addressing, control section 
addressing, and the function of the USING 
assembler instruction are not considered 
here. For discussion of these considera- 
tions and for examples of coding sequences 


that illustrate them, the reader is 
referred to Section 3, "Program Sectioning 
and Linking" and “Base Register Instruc- 
tions." 

RR Foritat 

cies i an cag aa Fra aa la 1 
|Name JOperation |Operand | 
eek ee 4 
|ALPHAI |LR |1,2 | 
JALPHA2 |LR | REG1L,REG2 | 
| BETA {SPM {15 \ 
|GAMMA1 |svc | 250 | 
|GAMMA2 |svc | TEN | 
paler ioe Bere te one eee en aS i a a Ss ae 3 


The operands of ALPHA1, BETA, and GAMMA1 
are decimal self-defining values, which are 
categorized as absolute expressions. The 


operands of ALPHA2 and GAMMA2 are symbols 
that are equated elsewhere to absolute 
values. 
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RX_Format 
ieee ca aaiasis Tete ane Tos se a ee 1 
| Name [Operation |Operand | 
| | | | 
}--------- +----------- 4------------------- { 
| ALPHA1L [L [1,39(4,10) | 
| ALPHA2 |L |] REG1, 39(4,TEN) | 
| BETA1 [L | 2, ZETA (4) | 
| BETA2 |L | REG2, ZETA (REGS) | 
| GAMMA1 [L |2,ZETA { 
| GAMMA2 |L | REG2, ZETA | 
| GAMMA3 |L |2,=F"1000° | 
| LAMBDA1 |L |3,20(,5) | 
tos slo s55 2 ag end det eS ee ee ees J 


Both ALPHA instructions specify explicit 
addresses; REG and TEN are absolute sym- 
bols. Both BETA instructions specify 


implied addresses, and both use index reg- 
isters. Indexing is omitted from the GAMMA 
instructicns. GAMMA1 and GAMMA2 specify 
implied addresses. The second operand of 


GAMMA3 is a literal. 
indexing. 


LAMBDA1 specifies no 


RS Format 
athe eee Tito oo Tear en a 1 
| Name [Operation |Operand | 
}--------}~---------- $----~~-------------- : 
{ALPHA1 |BXH {1,2,20(14) | 
[ALPHA2 {|BXH JREG1,REG2,20(REGD) | 
JALPHA3 |BXH |REGL,REG2, ZETA | 
|ALPHAG |SLL |REG2,15 | 
JALPHAS {SLL |REG2,0(15) | 
Une Lobe See Woes at Se J 
Whereas ALPHA1 and ALPHA2 specify ex- 
plicit addresses, ALPHA3 specifies an 
implied address. ALPHA4Y is a shift 
instruction shifting the contents of REG2 
left 15 bit positions. ALPHA5 is a shift 
instruction shifting the contents of REG2 


left by the value contained in general 
register 15. 
Si Format 
prc oe e pene ong ee ey 
| Name {Operation {|Operand | 
~~--~---}----------- f-—-a=~=~--~=~~--~-===4 
[ALPHA1 [CLI [40(9),x"40°' | 
{ALPHA2 |CLI | 40(REG9) , TEN { 
| BETA1 {CLI | ZETA, TEN | 
|BETA2  |CLI |ZETA,C'A' | 
|GAMMA1 |SIO }40(9) | 
|GAMMA2 | SIO }0(9) | 
|GAMMA3 | SIO }40(0) | 
{GAMMAG [5I0 | ZETA | 
lesG en Se Eecesehs oes WS et Soe Pe ee J 
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The ALPHA instructions and GAMMA1-GAMMA3 
specify explicit addresses, whereas the 
BETA instructions and GAMMA4 specify 
implied addresses. GAMMA2 specifies a dis- 
placement of zero. GAMMA3 does not specify 
a base register. 


SS Format 

iS Te eee ae a 1 
| Name |Operation|Operand | 
}-------- }--------- }---=~-~-----~--------- { 


JALPHA1 |AP 
JALPHA2 |AP 
JALPHA3 |AP 
JALPHAG |AP 


}40(9,8),30(6,7) | 
| 40 (NINE, REGS) , 30(L6,7) | 
| FIELD2,FIELD1 

| FIELD2 (9) , FIELD1(6) 


| 

|BETA JAP | FIELD2 (9) , FIELD1 | 
|GAMMA1 |MVC 140(9,8),30(7) | 
|GAMMA2 |MVC |40 (NINE,REG8),DEC(7) | 
|GAMMA3  |MVC | FIELD2 ,FIELD1 | 
|GAMMA4 = |MVC | FIELD2 (9) ,FIELD1 | 
bloat deeie Se Ses Sa 2 Se er a ee d 
ALPHA1, ALPHA2, GAMMA1, and GAMMA2 spec-~ 


ify explicit lengths and addresses. ALPHA3 
and GAMMA3 specify both implied length and 
implied addresses. ALPHA4 and GAMMA4 spec- 
ify explicit length and implied addresses. 
BETA specifies an explicit length for 
FIELD2 and an implied length for FIELD1; 
both addresses are implied. 


EXTENDED MNEMONIC CODES 





For the convenience of the programmer, 
the assembler provides extended mnemonic 
codes, which allow conditional branches to 
be specified mnemonically as well as 
through the use of the BC machine- 
instruction. These extended mnemonic codes 
specify both the machine branch instruction 
and the condition on which the branch is to 
occur. The codes are not part of the 
universal set of machine-instructions, but 


are translated by the assembler into the 
corresponding operation and condition 
combinations. 

The allowable extended mnemonic’ codes 
and their operand formats are shown in 
Figure 4-1, together with their machine- 
instruction equivalents. Unless otherwise 


noted, all extended mnemonics shown are for 
instructions in the RX format. Note that 
the only difference between the operand 
fields of the extended mnemonics and those 
of their machine-instruction equivalents is 
the absence of the Ri field and the comma 
that separates it from the rest of the 
operand field. The extended mnemonic list, 
like the machine-instruction list, shows 
explicit address formats only. Each 
address can also be specified as an implied 
address. 


fei SRE eet tesa RNA ER ac eh ae Na Se ON oe ea ae aly 
| 


Extended Code 
| 


Meaning 


[B D2 (X2,B2) Branch Unconditional 

[BR R2 Branch Unconditional (RR format) 
|NOP D2(X2,B2) No Operation 

|NOPR R2 No Operation (RR format) 
| 

| Used After Compare Instructions 

| 

| BH D2 (X2, B2) Branch on High 

| BL D2 (X2, B2) Branch on Low 

| BE D2 (X2,B2) Branch on Equal 

[BNH D2(k2,B2) Branch on Not High 

[BNL D2(X2,52) Branch on Not Low 

|BNE D2(x2,B2) Branch on Not Equal 

| 

| Used After Arithmetic Instructions 

\ 

[| Bo D2 (X2,B2) Branch on Overflow 

| BP D2 (X2,B2) Branch on Plus 

| BM D2 (2, B2) Branch on Minus 

[BZ D2 (KX2, B2) Branch on Zero 

[BNP D2(X2,B2) Branch on Not Plus 

|BNM D2 (X2,B2) Branch on Not Minus 

}BNZ D2 (X2,B2) Branch on Not Zero 

| 

| Used After Test Under Mask Instructions 
I 

| BO D2 (X2,B2) Branch if Ones 

{BM D2 (X2,B2) Branch if Mixed 

| BZ D2 (X2,B2) Branch if Zeros 

[BNO D2(X2,8B2) Branch if Not Ones 


Figure 4-1. Extended Mnemonic Codes 


In the following examples, which illus- The firs 
trate the use of extended mnemonics, it is uncondition 
to be assumed that the symbol GO is defined address. 


elsewhere in the progran. 


Machine-Instruction 


BC 15,D2(X2,B2) 
BCR 15,R2 
BC 0,D2(X2,B2) 
BCR 0,R2 


2,D2(X2, B2) 
4,D2(X2, B2) 
8,D2(X2, B2) 
13,D2(X2,B2) 
11,D2(X2,B2) 
7,D2(X2, B2) 


1,D2(X2,B2) 
2,D2(X2,B2) 
4,D2(X2,B2) 
8,D2(X2,B2) 
13,D2(X2,B2) 
11,D2(X2,B2) 
7,D2(X2,B2) 


1,D2(X2,B2) 
4,D2 (0X2, B2) 
8, D2 (X2, 32) 
14,D2(X2,B2) 


t two 
al 


instructions 
branch to 


an 
The address in the first case is 
the sun of the contents of base register 6, 
the contents of index register 3, 


specify an 
explicit 


and the 


r----- S aateniienieabentetententeaen | Stan eSaneSeaRneteeteeiestaeteehesteneneanaiientententeatan 4 displacement 40; the address in the second 
[Name |Operation [Operand | instruction is not indexed. The third 
-------+-----------4}----------------------f instruction specifies a branch on low to 
| [B {40(3, 6) | the address implied by GO as indexed by the 
| [|B |40¢, 6) | contents of index register 3; the fourth 
| | BL {Go (3) | instruction does not specify an index reg- 
| | BL | GO | ister. The last instruction is an uncondi- 
| | BR [4 | tional branch to the address contained in 
t----—__— 4 ——---—---~~-- i---——----—-------—-~—----~-- Jj register 4, 
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Just as machine instructions are used to 
request the computer to perform a sequence 
of operations during program execution 
time, so assembler instructions are 
requests to the assembler to perform cer- 
tain operations during the assembly. 
Assembler-instruction statements, in 
contrast to machine-instruction statements, 
do not usually cause machine-instructions 
to be included in the assembled program. 
Some, such as DS and DC, generate no 
instructions but do cause storage areas to 
ne set aside for constants and other data. 
Others, such as EQU and SPACE, are effec- 
tive only at assembly time; they generate 
nothing in the assembled program and have 
no etfect on the location counter. 
list of 


The following is a assembler 


instructions. 
Symbol Definition Instruction 
EQU - Equate Symbo 
Operation Code Definition Instruction 
OPSYN - Equate Operation Code (Assembler F 


only) 
Data Definition Instructions 
pc - Define Constant 
DS - Define Storage 
ccW - Define Channel Command Word 


* Program Sectioning and Linking Instruc- 
tions 


START - Start Assembly 


CSECT - Identify Control Section 

CXD - Cumulative Length of External 
Dummy Section (Assembler F only) 

DSECT - Identify Dummy Section 

DXD - Define External Dummy Section 
(Assembler F only) 

ENTRY - Identify Entry-Point Symbol 

EXTRN - Identify External Symbol 


WXTRN - Identify Weak External Symbol 
(Assembler F only) 

COM - Identify Blank Common Control 
Section 

* Base Register Instructions 

USING - Use Base Address Register 

DROP - Drop Base Address Register 

Listing Control Instructions 

TITLE - Identify Assembly Output 

EJECT - Start New Page 

SPACE - Space Listing 

PRINT - Print Optional Data 


Program Control Instructions 


ICTL - Input Format Control 

ISEQ - Input Sequence Checking 

ORG - Set Location Counter 

LTORG - Begin Literal Pool 

CNOP - Conditional No Operation 
COPY - Copy Predefined Source Coding 
END ~ End Assembly 


* Discussed in Section 3. 


Section 5: 


SECTION 5: ASSEMPLER INSTRUCTION STATEMENTS 


SYMBOL DEFINITION INSTRUCTION 


PUNCH - Punch a Card 
REPRO - Reproduce Following Card 


EQU -~- EQUATE SYMBOL 


The EQU instruction is used to define a 
symbol by assigning to it the length, 
value, and relocatability attributes of an 
expression in the operand field. The for- 
mat of the EQU instruction statement is as 
follows: 


|] Name | Operation | Operand | 
a ce 4+-————— 
jA variable | EQU | An : 
| Symbol or | | expression | 
j ordinary | | | 
[eee | | | 
Pda ic ep area eee ee oS Se a Se 


The expression in the operand field can 
be absolute or relocatable. Any symbols 
appearing in the expression must be pre- 
viously defined. 


The symbol in the name field is given 
the same length, value, and relocatibility 
attributes as the expression in the operand 
field. The length attribute of the symbol 
is that of the leftmost (or only) term of 
the expression. In the case of EQU to * or 
to a self-defining term, the length attri- 
bute is 1. The value attribute of the 
symbol is the value of the expression. 


The EQU instruction is used to equate 
symbols to register numbers, immediate 
data, or other arbitrary values. The 
following examples illustrate how this can 
be done: 


rr ata: Vo a eo eS 1 
[Name [Operation operand | 
------ 4$-----------}----------------------4 
|REG2 |EQU }2 (general register) | 
[tess | EQu |X'3F' (immediate data) | 
ee Aa ee eh a a 


To reduce programming time, the program- 
mer can equate symbols to frequently used 
expressions and then use the symbols as 
operands in place of the expressions. 
Thus, in the statement: 
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| Name JOperation |Operand | 
}------- $=--—— === $--------- wa----~----- { 
| | | | 
{FIELD |EQOU |] ALPHA- BETA+ GAMMA { 
ls Sec Pek See Bestel Seip eS J 
FIFLD is defined as ALPHA-BETA+GAMMA and 


may be used in place of it. Note, however, 
that ALPHA, BETA, and GAMMA must all be 
previously defined. If the final result of 
the expression is negative, it is treated 
as if it were positive, i.e., the low-order 
24 bits of the 2's complement is used. 


The assembler assigns a length attribute 
of 1 in an EQU to * statement. 


OPERATION CODE DEFINITION INSTRUCTION 





OPSYN -~ EQUATE OPERATION CODE (ASSEMBLER F 
ONLY) 


The OPSYN instruction is used to define 
a machine mnemonic or extended mnemonic 
operation code as equivalent to another 
operation code. It is also used to prevent 
the assembler from recognizing an operation 


code. The OPSYN instruction has two for- 
mats: 

pm aq 
; Name | Operation | Operand | 
SS er ee 
; Any OPSYN | A machine instruc- 
jordinary tion mnemonic code ,| 
;symbol, an extended mnem- | 


lassembler operation code de- 
loperation| finec by a previous 
Al i ee ie eel 

In this format, the OPSYN instruction 
assigns all the properties of the opera- 
tion code in the operand field to the 
symbol in the name field. The symbol in 
the name field can be a previously defined 
machine or extended mnemonic operation 
code. In this case, the latest definition 
takes precedence. 


peRcepe an onic code, or an 
| 


A machine or 
j extended mnem~ | 
j onic operation | 
j code Ht 


In this format, the OPSYN instruction 
prevents the assembler from recognizing 
the operation code in the name field. 


Only ICTL and OPSYN instructions may precede 


an OPSYN instruction. 
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Additional information on use of the OPSYN 
instruction is contained in IBM System/360 


Operating System Assembler (F) Programmer’s 
Guide (GC26-3756). 


DATA DEFINITION INSTRUCTIONS 


There are three data definition instrrc- 
tion statements: Define Constant (Di), 
Define Storage (DS), and Define Charael 
Command Word (CCW). 


These statements are used to enter 
data constants into storage, to define 
and reserve areas of storage, and to 
specify the contents of channel command 
words. The statements can be named by 
symbols so that other program statements 
can refer to the generated fields. The 
DC instruction is presented first and 
discussed in more detail than the DS 
instruction because the DS instruction 
is written in the same format as the 
DC instruction and can specify some or 
all of the information that the DC in- 
struction provides. Only the function 
and treatment of the statements vary. 


DC -- DEFINE CONSTANT 


The DC instruction is used to provide 
constant data in storage. It can specify 
one constant or a series of constants. 

A variety of constants can be specified: 
fixed-point, floating-point, decimal, 
hexadecimal, character, and storage 
addresses. (Data constants are generally 
called constants unless they are created 
from storage addresses, in which case 
they are called address constants.) 

The format of the DC instruction state- 
ment is as follows: 


(Hes ee TS Te es 1 
{Name [Operation |Operand | 
[---------- +----------- fo----------------- { 
| Any sym- {DC JOne or more | 
} bol or | joperands in | 
| blank | |the format | 
| | | described | 
| | jbelow, each | 
| | {Separated by { 
| | Ja comma L 
Bees ee Maser Shee ee SS Paes eee ems J 


Each operand consists of four subfields: 
the first three describe the constant, and 
the fourth subfield provides the nominal 
value(s) for the constant(s). The first 
and third subfields can be omitted, but the 
second and fourth must be specified. Note 
that nominal value(s) for more than one 
constant can be specified in the fourth 
subfield for most types of constants. Each 
constant so specified must be of the same 
type; the descriptive subfields that precede 
the nominal value apply to all of them. 

No blanks can occur within any of the sub- 
fields (unless provided as characters in a 
character constant or a character self- 
defining term), nor can they occur between 
the subfields of an operand. Similarly, 
blanks cannot occur between operands and 
the commas that separate them when multiple 
operands are being specified. 


The subfields of each DC operand are 
written in the following sequence: 


1 2 3 4 
Dupli- Type Modifiers Nominal Value (s) 
cation 
Factor 


Although the constants specified within 
one operand must have the same character- 
istics, each operand can specify a different 
type of constant. For example, in a DC 
instruction with three operands, the first 
operand might specify four decimal con- 
stants, the second a floating-point con- 
stant, and the third a character constant. 


The symbol that names the DC instruction 
is the name of the constant (or first 
constant if the instruction specifies more 
than one). Relative addressing (e.g., 
SYMBOL+2) can be used to address the var- 
ious constants if more than one has been 
specified, because the number of bytes 
allocated to each constant can be deter- 
mined. 


The value attribute of the symbol naming 
the DC instruction is the address of the 
leftmost byte (after alignment) of the 
first, or only, constant. The length 
attribute depends on two things: the type 
of constant being defined and the presence 
of a length specification. Implied lengths 
are assumed for the various constant types 
in the absence of a length specification. 
If more than one constant is defined, the 
length attribute is the length in bytes 
(specified or implied) of the first con- 
stant. 


Boundary alignment also varies according 
to tne type of constant being specified and 
the presence of a length specification. 


Some constant types are only aligned to a 
byte boundary, but the DS instruction can 
be used to force any type of word boundary 
alignment for them. This is explained 
under “DS -- Define Storage." Other con- 
stants are aligned at various word boundar- 
ies (half, full, or double) in the absence 
of a length specification. If length is 
specified, no boundary alignment occurs for 
such constants. 


Bytes that must be skipped in order to 
align the field at the proper boundary are 
not considered to be part of the constant. 
In other words, the location counter is 
incremented to reflect the proper boundary 
(if any incrementing is necessary) before 
the address value is established. Thus, 
the symbol naming the constant will not 
receive a value attribute that is the 
location of a skipped byte. 


Any bytes skipped in aligning statements 
that do not cause information to be assem- 
bled are not zeroed. Bytes skipped to 
align a DC statement are zeroed; bytes 
skipped to align a DS statement are not 
zeroed. 


Appendix F summarizes, in chart form, 
the information concerning constants that 
is presented in this section. 


LITERAL DEFINITIONS: The reader is remind- 
ed that the discussion of literals as 
machine-instruction operands (in Section 2) 
referred him to the description of the DC 
operand for the method of writing a literal 
operand. All subsequent operand specifi- 
cations are applicable to writing literals, 
the only differences being: 


1. The literal is precedeaqd by an equal 
Sign. 

2. Multiple operands may not be speci- 
fied. 

3. Unsigned decimal self-defining terms 
must be used to express the duplica- 
tion factor and length modifier 


values. 

4. The duplication factor may not be 
ZELO. 

5. S-type address constants may not be 
specified. 


6. Signed or unsigned decimal selif- 
defining terms must be used to express 
scale and exponent modifiers. 

7. Q-type address constants may not be 
specified in literals. 


Examples of literals appear throughout 
the balance of the pc instruction 
discussion. 
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Type of Constant Machine Format 





ea tne tt eT NER 


Cc Character 8-bit code for each character 

Xx Hexadecimal 4-bit code for each hexadecimal digit 

B Binary binary format 

F Fixed-point Sigried, fixed-point binary format; normally a full word 

H Fixed-point Signed, fixed-point binary format; normally a half word 

E Floating-point Short floating-point format; normally a full word 

D Floating-point Long floating-point format; normally a double word 

L Floating-point Extended floating-point format; normally two double words 
(Assembler F only) 

P Decimal Packed decimal format 

Zz Decimal Zoned decimal format 

A Address Value of address; normally a full word 

Y Address Value of address; normally a half word 

$ Address Base register and displacement value; a half word 

Vv Address Space reserved for external symbol addresses; each address 
normally a full word 

Q Address Space reserved for dummy section offset 


(Assembler F only) 





Figure 5-1. Type Codes for Constants 


Operand Subfield 1: Duplication Factor 





The duplication factor may be omitted. 
T£ specified, it causes the constant(s) to 
be generated the number of times indicated 
by the factor. The factor may be specified 
either by an unsigned decimal self-defining 


term or by a positive absolute expression 
that is enclosed by parentheses. The 
Quplication factor is applied after the 


constant is assembled. All symbols in the 
expression must be previously defined. 


Note that a duplication factor of zero 
is permitted except in a literal and 
achieves the same result as it would ina 
DS instruction. A DC instruction with a 
zero duplication factor will not produce 
control dictionary entries. See "Forcing 
Alignment” under "DS -- Define Storage." 


Note: If duplication is specified for an 
address constant containing a location 
counter reference, the value of the loca- 
tion counter used in each duplication is 
incremented by the length of the operand. 
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The type subfield defines the type of 
constant being specified. From the type 
specification, the assembler determines how 
it is to interpret the constant and trans- 


late it into the appropriate machine for- 
mat. The type is specified by a_ single- 
letter code as shown in Figure 5-1. 

Further information about these 
constants is provided in the discussion of 
the constants themselves under "Operand 
Subfield 4: Constant." 


Operand Subfield 3: Modifiers 


Modifiers describe the length in bytes 
desired for a constant (in contrast to an 
implied length), and the scaling and expo- 
nent for the constant. If multiple modifi- 


ers are written, they must appear in this 
sequence: length, scale, exponent. Each is 
written and used as described in the fol- 


lowing text. 


LENGTH MODIFIER: This is written as Ln, 
where n is either an unsigned decimal self- 
defining term or a positive absolute ex- 
pression enclosed by parentheses. Any 
symbols in the expression must be previously 
defined. The value of n represents the 
number of bytes of storage that are assem- 
bled for the constant. The maximum value 
permitted for the length modifiers supplied 
for the various types of constants is sum- 
marized in Appendix F. This table also 
indicates the implied length for each type 
of constant; the implied length is used 
unless a length modifier is present. A 
length modifier may be specified for any 
type of constant. However, no boundary 
alignment will be provided when a length 
modifier is given. 


Use of a length modifier may cause 
truncation. For example, 


DC C'ABCDXYZ' 
will generate a 7-byte constant, whereas 
DC CL6'ABCDXYZ' 


will generate a 6-byte constant and cause 
Z to be lost. Truncation of C, X, B, &@, 
A, Y, and P constants is not flagged as 
an error. However, F, H, E, D, and L 

. constants will be flagged if significant 
bits are lost. Finally, each type of 
constant has an imposed or natural length 
modifier range limit. Appendix F shows 
which constants can be flagged for trunca- 
tion of significant digits. It also shows 
the allowable length modifier range for 
each constant. 


Bit-Length Specification: The length of a 
constant, in bits, is specified by L.n, 
where n is specified as stated above and 
represents the number of bits in storage 
into which the constant is to be assembled. 
The value of n may exceed eight and is 
interpreted to mean an integral number of 
bytes plus so many bits. For example, L.20 
is interpreted as a length of two bytes 
plus four bits. 





Assembly of the first or only constant 
with bit-length specification starts on a 
byte boundary. The constant is placed in 
the high or low order end of the field 
depending on the type of constant being 
specified. The constant is padded or trun- 
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cated to fit the field. If the assembled 
length does not leave the location counter 
set at a byte boundary, and another bit 
length constant does not immediately follow 
in the same statement, the remainder of the 
last byte used is filled with zeros. This 
leaves the location counter set at the next 
byte boundary. Figure 5-2 shows a fixed- 
point constant with a specified bit-length 
of 13, as coded, and as it would appear in 
storage. Note that the constant has been 
padded on the left to bring it to its 
designated 13-bit length. 


As coded: 
[eo Nee oe a ey po ge | eae Ea fee Ce eae ee ee ee 7 
| Name | Operation !' Operand ! 
este Gepee uel teen ee Sees ae 4 
i 
!prcon | pe 1 FL.13'579!' 4 
Loves Sas becot ook Le Bi apes ce teeter ape eee ere 4 


In storage: 


byte byte byte 


padding 
A 
0001001000011000 
eyo ee 


579 fill 


Figure 5-2. Bit-Length Specification 


(Single Constant) 


The implied length of BLCON is two 
bytes. A reference to BLCON would cause 
the entire two bytes to be referenced. 


When bit-length specification is used 
in association with multiple constants 
(see Operand Subfield 4: Constant 
following), each succeeding constant in 
the list is assembled starting at the 
next available bit. Figure 5-3 illustrates 


this. 
As coded 

ort prt rrr rae a 
( 1 i} 
1‘ Name 4 Operation Operand } 
Pea poe 7a gee a 
| BLMCON: DC | FL.10'161,21,57' 
! : i ' 
ee ee ee Ladenieteieckontenieieed -! 
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In storage: 


byte byte byte byte byte 


paddin padding 


0010100001000001/01010000111100100 
ey yee ey 


161 21 57 fill 


Figure 5-3. Bit-Length Specification 


(Multiple Constants) 


The symbol used as a name entry in a DC 
assembler instruction takes on the length 
attribute of the first constant in the 
list; therefore the implied length of 
BLMCON in Figure 5-3 is two bytes. 


If duplication is specified, filling 
occurs once at the end of the field occu- 
pied by the duplicated constant(s). 


When bit-length specification is used in 
association with multiple operands, assem- 
bly of the constant(s) in each succeeding 
operand starts at the next available bit. 
Figure 5-4 illustrates this. 


As coded: 
joo et ease S eee eS eee ce cee eet ee ete 
; 
H | Oper- | ' 
Name ‘ation _Operand ' 


IBLMOCON | DC 


a Spd ee a el Mo ras ee a a ae! a a ee ae at Ee eae 


In storage: 





byte byte byte byte byte 
padding paddin 
nas —— 
00010011/:0000011/10000001/10001000 
ty Seen ee | 
9 A c4 fill 
——--—_ —— 
A plus 
first two 
bits of B 


Figure 5-4. Bit-Length Specification 


(Multiple Operands) 


In Figure 5-4, three different types of 
constants have been specified, one to an 
operand. Note that the character constant 
"AB' which normally would occupy 16 bits is 
truncated on the right to fit the 10-bit 
field designated. Note that filling occurs 
only at the end cf the field occupied by 
all the constants. 
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Scale Modifier: This modifier is written 
as Sn, where n is either a decimal value or 
an absolute expression enclosed by paren- 
theses. All symbols in the expression must 
be previously defined. The decimal self- 
defining term or the parenthesized expres- 
sion may be preceded by a sign; if none 

is present, a plus sign is assumed. The 
maximum values for scale modifiers are 
summarized in Appendix F. 


A scale modifier may be used with fixed- 
point (F, H)} and floating-point (E,D,L) 
constants only. It is used to specify the 
amount of internal scaling that is desired, 
as follows: 


Scale Modifier for Fixed-Point Constants: 


the scale modifier specifies the power of 
two by which the constant must be 
multiplied after it has been converted to 
its binary representation. Just as multi- 
plication of a decimal number by a power 
of 10 causes the decimal point to move, 
multiplication of a binary number by a 
power of two causes the binary point to 
move. This multiplication has the effect 
ef moving the binary point away from its 
assumed position in the binary field; the 
assumed position being to the right of the 
rightmost position. 


Thus, the scale modifier indicates 
either of the following: (1) the number of 
binary positions to be occupied by the 
fractional portion of the binary number, 
or (2) the number of binary positions to 
be deleted from the integral portion of 
the binary number. A positive scale of x 
shifts the integral portion of the number 
x binary positions to the left, thereby 
reserving the rightmost x binary positions 
for the fractional portion. A negative 
scale shifts the integral portion of the 


number right, thereby deleting rightmost 
integral positions. If a scaie modifier 
does not accompany a fixed-point constant 


containing a fractional part, the fraction- 
al part is lost. 


In all cases where positions are lost 
because of scaling (or the tlack of 
scaling), rounding occurs in the leftmost 


bit of the lost portion. The rounding is 


reflected in the rightmost position saved. 
Scale Modifier for Floating-Point Con- 
Stants: Only a positive scale modifier may 


be used with a floating-point constant. It 
indicates the number of hexadecimal posi- 
tions that the fraction is to be shifted to 
the right. Note that this shift amount is 
in terms of hexadecimal positions, each of 
which is four binary positions. (A posi- 
tive scaling actually indicates that the 
point is to be moved to the left. However, 
a floating-point constant is always con- 
verted to a fraction, which is hexadeci- 


mally normalized. The point is assumed to 
be at the left of the leftmost position in 
the field. Since the point cannot be moved 
left, the fraction is shifted right.) 


Thus, scaling that is specified for a 
floating-point constant provides an assem- 
bled fraction that is unnormalized, i.e., 
contains hexadecimal zeros in the leftmost 
positions of the fraction. When the frac- 
tion is shifted, the exponent is adjusted 
accordingly to retain the correct magni- 
tude. When hexadecimal positions are lost, 
rounding occurs in the leftmost hexadecimal 
position of the lost portion. The rounding 
is reflected in the rightmost hexadecimal 
position saved. 


EXPONENT MODIFIER: This modifier is 
ten as En, where on 
self-defining term or an absolute expres- 
sion enclosed by parentheses. Any symbols 
in the expression must be previously 
agefined. The decimal value or the paren- 
thesized expression may be preceded by a 
sign; if none is present, a plus sign is 
assumed. 


writ- 
is either a decimal 


An exponent modifier may be used with 
fixed-point (F, H) and floating-point 
(E,D,L) constants only. The modifier 
denotes the power of 10 by which the 
constant is to be multiplied before its 
conversion to the proper internal format. 


This modifier is not to be confused with 
the exponent of the constant itself, which 
is specified as part of the constant and is 
explained under “Operand Subfield 4: Con- 


stant." The exponent modifier affects each 
constant in the operand, whereas the expo- 


nent written as part of the constant only 
pertains to that constant. Thus, a con- 
stant may be specified with an exponent of 
+2, and an exponent modifier of +5 may 
precede the constant. In effect, the con- 
Stant has an exponent of +7. 


The range for the exponent modifier is 
-85 through +75. However, if there is an 
exponent in the constant itself (see "Float- 
ing-Point Constants -- E, D;, and L" under 
"Operand Subfield 4: Constant") the sum of 
that exponent and the exponent modifier 
must be within the range -85 - +75. Thus, 
an exponent modifier of -40 together with 
an exponent of ~47 would not be permitted. 
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One further limitation is that the value 
specified must be contained in the 
implied length of the constant. Refer 

to "Floating Point Arithmetic" in 


IBM System/360 Principles of Operation 
(GA22-6821). 


Operand Subfield 4: Constant 


This subfield supplies the constant (or 
constants) described by the subfields that 
precede it. A data constant (any type 
except A, Y, S, Q and V) is enclosed by 
apostrophes. An address constant (type A, 
Y, S, Q, or V) is enclosed by parentheses. 
To specify two or more constants in the 
subfield, the constants must be separated 
by commas and the entire sequence of con- 
stants must be enclosed by the appropriate 
delimiters (i.e., apostrophes or 
parentheses). Thus, the format for speci- 
fying the constant(s) is one of the follow- 
ing: 


Single Multiple 

Constant Constants* 

‘constant! "constant, ..., constant‘ 
(constant) (constant,...,constant) 


* Not permitted for character, hexadecimal, 
and binary constants. 


All constant types except character (C), 
hexadecimal (X), binary (B), packed decimal 
(P), and zoned decimal (Z), are aligned on 
the proper boundary, as shown in Appendix 
F, unless a length modifier is specified. 
In the presence of a length modifier, no 
boundary alignment is performed. If an 
operand specifies more than one constant, 
any necessary alignment applies to the 
first constant only. Thus, for an operand 
that provides five full-word constants, the 
first would be aligned on a full-word 
boundary, and the rest would automatically 
fail on full-word boundaries. 


The total storage requirement of an 
operand is the product of the length times 
the number of constants in the operand 
times the duplication factor (if present) 
plus any bytes skipped for boundary align- 
ment of the first constant. If more than 
one operand is present, the storage 
requirement is derived by summing the 
requirements for each operand. 
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If an address constant contains a loca- 
tion counter reference, the lLcecation count- 
er value that is used is the storage 
address of the first byte the constant wiil 
occupy. Thus, if several address constants 
in the same instruction refer to the loca- 
tion counter, the value of the location 
counter varies from constant to constant. 
Similarly, if a single constant is speci- 
fied (and it is a location counter 
reference) with a duplication factor, the 
constant is duplicated with a varying loca- 
tion counter value. 


The following text describes each of the 
constant types and provides examples. 


Character Constant ~- C: Any of the valid 
256 punch combinations can be designated in 
a character constant. Only one character 
constant can be specified per operand. 
Since multiple constants within an operand 
are Separated by commas, an attempt to 
specify two character constants results 

in interpreting the comma separating them 
as a character. 


Special consideration must be given to 
representing apostrophes and ampersands as 
characters. Fach single apostrophe or 
ampersand desired as a character in the 
constant must be represented by a pair of 
apostrophes or ampersands. Only one apos- 
trophe or ampersand appears in storaqde. 


The maximum length of a character con- 
stant ais 256 bytes. No boundary alignment 
is performed. Each character is transléeted 
into one byte. Double apostrophes or dou- 
ble ampersands count aS one character. If 
no dength modifier is given, the size in 
bytes of the character constant is equal to 
the number of characters in the constant. 
If a length modifier is provided, the 
result varies as follows: 


1. «If the numser of characters in the 
constant exceeds the specified length, 
as many rightmost bytes and/or bits as 
necessary are dropped. 


2. If the number of characters is less 
than the specified length, the excess 
rightmost bytes and/or bits are filled 
with blanks. 


In the following example, the length 
attribute of FIELD is 12: 
ara Porn es ee ee ee ee 
| Name [Operation |Operand | 
}------- wanna noe nna f = +22 === === === =f 
| FIELD {pe jC'TOTAL IS 110° { 
epee Pes Oe 2k ee oe ee Se 
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However, in this next example, the 
length attribute is 15, and three blanks 
appear in storage to the right of the zero: 


(Seo Cael ae eS ee ee a ee 1 
Vonetaeson |Operand | 


In the next example, the length attri- 
bute of FIELD is 12, although 13 characters 
appear in the operand. Tne two ampersands 
count as only one pyte. 


(oS ee ee ee ee ge ee ee 7 
| Name | Operation loperanad | 
-~~----- }~--~-------}---------------------4 
|FIELD |LC JC'TOTAL IS &&10' | 
| | | | 
Leo tee Dee wee eS hee Se eee J 


Note that in the next example, a length 
of four has been specified, but there are 
five characters in the constant. 


(Paginas Too SSS SS Tas Te PT eS ee 1 
|Name |Operation |{Operand | 
------- $----------- $2 == 20 == 
| FIELD Dc | 3CL4"ABCDE' | 
oe aeetes ote BP eh oe as oe I Se a 


The generated constant would be: 
ABCDABCDABCD 

On the other hand, if the length had 
been specified as six instead of four, the 
generated constant would have been: 
ABCDE ABCDE ABCDE 


Note that the same could be 


specified as a literal. 


constant 


4 
JAREA(12), =3CL4"ABCDE' | 
VS Set dis ae ee ee ee dj 


Hexadecimal Constant -~ X: A hexadecimal 
constant consists of one or more of the 
hexadecimal digits, which are 0-9 and A-F. 
Only one hexadecimal constant can be speci- 
fied per operand. The maximum length of a 
hexadecimal constant is 256 bytes (512 
hexadecimal digits). No boundary alignment 
is performed. 


Constants that contain an even number of 
hexadecimal digits are translated as one 
byte per pair of digits. If an odd number 


of digits is specified, the leftmost byte 
has the leftmost four bits filled with a 
hexadecimal zero, while the rightmost four 
bits contain the odd (first) digit. 


If no length modifier is given, the 
implied length of the constant is half the 
number of hexadecimal digits in the con- 
stant (assuming that a hexadecimal zero is 
added to an odd number of digits). If a 
length modifier is given, the constant is 
handled as follows: 


1. «If the number of hexadecimal digit 
pairs exceeds the specified length, 
the necessary leftmost bits (and/or 
bytes) are dropped. 


2. If the number of hexadecimal digit 
pairs is less than the specified 
length, the necessary bits (and/or 
bytes) are added to the left and 
filled with hexadecimal zeros. 


An eight-digit hexadecimal constant pro- 
vides a convenient way to set the bit 
pattern of a full binary word. The con- 
Stant in the following example would set 
the first and third bytes of a word to l's: 


| Name Toperation Joperana | 
}------ $----------- foa--- HH === 4 

| Ds | OF | 
| TEST |DC es FFOOFFOO' | 
lon s= ott oe eS ee ee J 


The DS instruction sets the location 


counter to a full word-boundary. (See 
DS~-Define Symbol.) 
The next example uses a hexadecimal 


constant as a literal and inserts l's into 
bits 24 through 31 of register 5. 


In the following example, the digit A 
is dropped, because five hexadecimal 
digits are specified for a length of two 
bytes: 
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The resulting constant is 6F4E, which 
occupies the specified two bytes. It is 
duplicated three times, as requested by 
the duplication factor. If it had merely 
been specified as X'A6F4E', the resulting 
constant would have a hexadecimal zero in 
the leftmost position. 


OA6 F4E0A6FAEQAGF4E 


Binary Constant -- B: A binary constant is 
written using 1s and 0's enclosed in apos- 


trophes. Only one binary constant can be 
specified in an operand. Duplication and 
length can be specified. The maximum 
length of a binary constant is 256 bytes. 


The implied length of a binary constant 
is the number of bytes occupied by the 
constant including any padding necessary. 
Padding or truncation takes place on the 
left. The padding bit used is a 0. 
the 


The following example shows coding 


used to designate a binary constant. B8CON 
would have a length attribute of 1. 
aac St Va ata Oa la tad ae 1 
|Name |Operation |Operand | 
j---~~---+----------- $------------------+- { 
| BCON |Dc | B°'11011101" | 
{BTRUNC |DC |BL1"'100100011' | 
| BPAD |pc ea 101° I 
hese ee en Dae eee a ee ee 4 
BTRUNC would assemble with the leftmost 


bit truncated, as follows: 
00100011 


BPAD would assemble with five zeros as 


padding, as follows: 

00000101 

Fixed-Point Constants -- F and H: A fixed- 
point constant is written as a decimal 


number, which can be followed by a decimal 
exponent if desired. The number can be an 
integer, a fraction, or a mixed number 
(i.e., one with integral and fractional 
portions). The format of the constant is 
as follows: 


1. The number is written as a signed or 
unsigned decimal value. The decimal 
point can be placed before, within, or 
after the number. If it is omitted, 
the number is assumed to be an integer. 
A positive sign is assumed if an un- 
signed number is specified. Unless a 
scale modifier accompanies a mixed 
number or fraction, the fractional 
portion is lost, as explained under 
Subfield 3: Modifiers. 
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2. The exponent is optional. If speci- 
fied, it is written immediately after 
the number as En, where n is an 
optionally signed cecimal self- 
defining term specifying the exponent 
of the factor 10. The exponent may be 


in the range -85 to +75. If an 
unsigned exponent is specified, a plus 
Sign is assumed. The exponent causes 


the value of the constant to be 
adjusted by the power of 10 that it 
specifies before the constant is con- 
verted to its binary form. The expo- 
nent may exceed the permissible range 
for exponents, provided that the sum 
of the exponent and the exponent modi- 
fier does not exceed that range. 


The number is converted to a binary 
number, and scaling is performed if speci- 
fied. The binary number is then rounded 
and assembled into the proper field, 
according to the specified or implied 
length. The resulting number will not 
differ from the exact value by more than 
one in the last place. If the value of the 


number exceeds the length specified or 
implied, the sign is lost, the necessary 
leftmost bits are truncated to the length 


. of the field, and the value is then assem- 
bled into the whole field. Any duplication 
factor that is present is applied after the 
constant is assembled. A negative number 
is carried in 2's complement form. 


An implied length of four bytes is 
assumed for a full-word (F) and two bytes 
for a half-word (H), and the constant is 
aligned to the proper full-word or half- 
word if a length is not specified. 
However, any length up to and including 
eight bytes can be specified for either 
type of constant by a length modifier, in 
which case no boundary alignment occurs. 


Maximum and minimum values, exclusive of 





scaling, for fixed-point constants are: 
Length Max Min 

8 263-1 =263 

4 234-1 ~241 

2 215-4 -215 

1 27-1 -27 


A field of three fuli-words is generated 
from the statement shown below. The Loca- 
tion attribute cf CONWRD is the address of 
the leftmost byte of the first word, and 
the length attribute is 4, the implied 
length for a full-word fixed-point con- 
stant. The expression CONWRD+4 could be 
used to address the secona constant (second 
word) in the field. 
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+ 
[CONRRD |DC | 3F'658474' | 
pales eee an feats is See eS Spee ETS, mn ee ee 


The next statement causes the generation 


of a two-byte field containing a negative 
constant. Notice that scaling has been 
specified in order to reserve six bits for 


the fractional portion of the constant. 


(eo eral eg en ee ee 1 
|Name (Operation Voperana | 
}----~----}-~--------- fo-- ~~~ ne === { 
[HAEECON [Dc JHS6'-25.46' | 
folate es Spee ape meee Cede te age EE ane aS 
The next constant (3.50) is multiplied 
by 10 to the power -2 before being con- 
verted to its binary format. The scale 
modifier reserves 12 bits for the 
fractional portion. 
(8 oe eS ee Oe er ee eee 1 
|Name LOperae Lon iGsetana | 
}--------- f----------- 4-~-~--------------- 4 
|FULLCON |DC ete 3.50E-2' | 
Le oe SS eee ee ee J 


The same constant could be specified as 
a literal: 


fecoe te OP bey = eS ATEN IE Sg gg eI EY te og gat a at ge q 
| Name operat ton jonerand | 
{------ 4o----------}---------------—--- === 4 
| [| AH {7 =HS12'3.50E-2' | 
(hese se bot Sahota ed ee ee SE J 

The final example specifies three con- 
Stants. Notice that the scale modifier 
requests four bits for the fractional por- 
tion of each constant. The four bits are 
provided whether or not the fraction 
exists. 


ance para Te eae ee ee 1 
|Name |Operation loperand | 
p---~~----- fo=--------- 4------------------ : 
|THREECON |DC [Fst 10,25.3,100' | 
boon es Bocas eee ee J 
Floating-Point Constants -- E, D, and L: A 








floating-point constant is written as a 
decimal number. As an option a decimal 
exponent may follow. The number may be an 
integer, a fraction, or a mixed number 
(i.e., one with integral and fractional 
portions). The format of the constant is 
as follows: 


SHORT FLOATING POINT NUMBER (E} 


7BIT 
S} CHARAC- 
TERISTIC 
4 


9) 78 31 





LC 4 FLOATING POINT NUMBER (0) 


7 BIT 
CHARAC. 
TERISTIC 


0 78 


56-BIT FRACTION 


EXTENDED FLOATING POINT NUMBER (L) 


7 BIT 
S| CHARAC.- 
TERISTIC 





63 


HIGH ORDER HALF OF 
112 BIT FRACTION 





i) 78 


—_ 


0 78 








Figure 5-5. 


1. The number is written as a signed or 
unsigned decimal value. The decimal 
point can be placed before, within, or 
after the number. If it is omitted, 


the number is assumed to be an integer. 


A positive sign is assumed if an un- 
signed number is specified. 


2. The exponent is optional. If speci- 
fied, it is written immediately after 
the number as En, where n is an 
optionally signed decimal value speci- 
fying the exponent of the factor 10. 
If an unsigned exponent is specified, 
a plus sign is assumed. The range of 
the exponent is explained under 
"Exponent Modifier" above. 


The external format for a floating-point 
number has two parts: the portion contain- 
ing the exponent, which is sometimes called 
the characteristic, followed by the portion 
containing the fraction, which is sometimes 
called the mantissa. Therefore, the number 
specified as a floating-point constant must 
be converted to a fraction before it can be 
translated into the proper format. Figure 
5-5 shows the external format of the three 
types of floating-point constants. 


The type L constant resembles two 
contiguous type D constants. In the type 
L constant the sign of the second double 
word is the same as the sign of the first. 
The characteristic of the second double 
word is equal to the characteristic of the 
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Floating-Point External Formats 


63 


LOW ORDER HALF OF 
112 BIT FRACTION 


63 


first minus 14, modulo 128. For informa- 
tion on use of the type L constant see the 


Assembler (F) Programmer's Guide. 


For example, the constant 27.35E2 repre- 
sents the number 27.35 times 10 to the 2nd. 
Represented as a fraction, it would be 
-2735 times 10 to the 4th, the exponent 
having been modified to reflect the shift- 
ing of the decimal point. The exponent may 
also be affected by the presence of an 
exponent modifier, as explained under 
"Operand Subfield 3: Modifiers." Thus, the 
exponent is also altered before being 
translated into machine format. 


In machine format a floating-point number 
also has two parts, the signed exponent and 
signed fraction. The quantity expressed by 
this number is the product of the fraction 
and the number 16 raised to the power of 
the exponent. 


The exponent is translated into its binary 
equivalent in excess 64 binary notation and 
the fraction is converted to a binary num- 
ber. Scaling is performed if specified; 
if not, the fraction is normalized (leading 
hexadecimal zeros are removed). Rounding of 
the fraction is then performed according to 
the specified or implied length, and the 
number is stored in the proper field. The 
resulting number will not differ from the 
exact value by more than one in the last 
place. Within the portion of the floating- 
point field allocated to the fraction, the 
hexadecimal point is assumed to be to the 
left of the leftmost hexadecimal digit, and 
the fraction occupies the leftmost portion 
of the field. Negative fractions are 
carried in true representation, not in the 
2s complement form. 
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An implied length of four bytes is 
assumed for a short (E) constant and eight 
bytes for a long (D) constant. An implied 
length of 16 bytes is assumed for an _ 
extended (L) constant. The constant is 
aligned at the proper word (E) or double 
word (D and L) boundary if a length is 
not specified. However, any length up 
to and including eight bytes (E and D) or 
16 bytes (L) can be specified by a length 
modifier. In this case, no boundary 
alignment occurs. 


Any of the following statements could be 
used to specify 46.415 as a positive, 
full-word, floating-point constant; the 
last is a machine-instruction statement 
with a literal cperand. Note that the last 
two constants contain an exponent modifier. 


tran To ee eS 5 oie meial ie as ) 
|Name |Operaticn [Operand | 
j------ $----------- fawn anne nen { 
| jDCc JE'46.415' | 
| | Dc {E'46415F-3' | 
| jpe JE'+464.15F-1' | 
| jDc JE'+.46415E+2" | 
| jpc JEE2'.46415' | 
| | AE [6,=EE2'.46415' | 
Weer dipessSoasen hee S28 Sot oe ee eS 4 


The following would each be generated as 
double-word floating-point constants. 


(== => Totes Sa= SSS SHS ea Sa re 1 
| Name [Operation |Operand | 
ae ef fe en nr 

[FLOAT |DCc [DE+4'4+46,-3.729,+473"' | 
[Sareea ener es Ba os Beis Po tee ee eA ee ee J 
Decimal Constants -- P and 2: A decimal 


constant is written as a Signed or unsigned 


decimal value. If the sign is onitted, a 
plus sign is assumed. The decimal point 
may be written wherever desired or may be 
omitted. Scaling and exponent modifiers 


may not be specified for decimal constants. 
The maximum length of a decimal constant is 
16 bytes. No word boundary alignment is 
perforned. 


The placement of a decinal point in the 
definition does not affect the assembly of 
the constant in any way, because, unlike 
fixed-point and floating-point constants, a 
decimal constant is not converted tc its 
binary equivalent. The fact that a decimal 
constant is an integer, a fraction, or a 
mixed number iS not pertinent to its gener- 
ation. Furthernore, the decimal point is 
not assembled into the constant. The pro- 
grammer may determine proper decimal point 
alignment either by defining his data so 
thet the point is aligned or by selecting 
machine-instructions that will operate on 
the data properly (i.e., shift it for 
purposes cf alignment). 
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If zoned decimal format is specified 
(Z), each decinal digit is translated into 
one byte. Tne translation is done accord- 
ing to the character set shcwn in Appendix 
A. The rightmost byte contains the sign as 


well as the rightmost digit. For packed 
decimal format (P), each pair of decimal 
digits is translated into one byte. The 


rightmost digit and the sign are translated 
into the rightmost byte. The bit configu- 
ration for the digits is identical to the 


configurations for the hexadecimal digits 
0-9 as shown in Section 3 under 
"Hexadecimal Self-Defining Value." For 


both packed and zoneé decimals, a plus sign 
is translated into the hexadecimal digit C, 
and a minus sign into the digit D. 


If an even number of packed decimal 
digits is specified, one digit will be left 
unpaired because the rightmost digit is 
paired with the sign. Therefore, in the 
leftmost byte, the leftmost four bits will 
be set to zeros and the rightmost four bits 
will contain the odd (first) digit. 


If no length modifier is given, the 
implied iength for either constant is the 
number of bytes the constant occupies 
(taking into account the format, sign, and 
possible addition of zero bits for packed 
decimals). If a length modifier is given, 
the constant is handled as follows: 


1. If the constant requires fewer bytes 
than the length specifies, the neces- 


Sary number of bytes is added to the 
left. For zoned decimal format, the 
decimal digit zero is placed in each 
added byte. For packed decimals, the 
bits of each added byte are set to 
zero. 


2. If the constant requires more bytes 


than the length specifies, the neces- 
Sary number of leftmost digits or 
pairs of digits is dropped, depending 


on which format is specified. 


Examples of decimal constant definitions 
follow. 


fess a= Tae a ee Pacman ieee ria aaa ea ace 1 
{Name |Operation |Operand | 
[----~- $----------- }------—----------~=--- { 
| }Dc [P'4+1.25' | 
| | pec [z'-543' | 
| | bc {Z'79.68" | 
| ] De |PL3'79.68° | 
ee eee eae ES ree a iN ee HO Ee 4 

The following statement specifies both 
packed and zoned decimal constants. The 


length modifier applies to each constant in 
the first operand (i.e., to each packed 
Gecimal constant). Note tnat a literal 
could not specify both operands. 


| Name TOpezatiion Téperand | 
ee ee ee eee a $-----------+-+-~--- 
|DECIMALS |DC {PL8'+25.8,-3874, | 
| | Aes 3°,2Z'+80,-3.72' | 
le2S5ooa5 bee SoS So Sh he es ee ke J 


The last example illustrates the use of 
a packed decimal literal. 
Gubveiessuc oso Se eects oe Se oe ees : 
|Name Joperation joperand | 
}------}+-----------4---------------------- 
| | UNPK OUTAREA, =PL2'+25" | 
Poss Mee a So ee a a J 


Address Constants: An address constant is 
a storage address that is translated into a 
constant. Address constants can be used 
for initializing base registers to facili- 
tate the addressing of storage. Further- 
more, they provide a means of communicating 
between control sections of a multisection 
program. However, storage addressing and 
control section communication are also 
dependent on the use of the USING assembler 
instruction and the loading of registers. 
Coding examples that illustrate these con- 
siderations are provided in Section 3 under 
"Programming with the Using Instruction." 


An address constant, unlike other types 
of constants, is enclosed in parentheses. 
If two or more address constants are speci- 
fied in an operand, they are separated by 
commas, and the entire sequence is enclosed 
by parentheses. There are five types of 
address constants: A, Y, S, Q and V. A 
relocatable address constant may not be 
specified with bit lengths. 


Complex Relocatable Expressions: A complex 
relocatable expression can only be used to 


specify an A-type or Y-type address con- 
stant. These expressions contain two or 
more unpaired relocatable terms and/or 
negative relocatable terms in addition to 
any absolute or paired relocatable terms 
that may be present. A complex relocatable 
expression might consist of external sym- 
bols and designate an address in an inde- 
pendent assembly that is to be linked and 
loaded with the assembly containing the 
address constant. 


A-Type Address Constant: This constant is 


specified as an absolute, relocatable, or 
complex relocatable expression. (Remember 
that an expression may be single term or 


multiterm.) The value of the expression is 
calculated to 32 bits as explained in 
Section 2 with one exception: the maximum 
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value of the expression may be 234-1. The 


value is then truncated on the left, if 
necessary, to the specified or implied 
length of the field and assembled into the 


rightmost bits of the field. The implied 
length of an A-type constant is four bytes, 
and alignment is to a full-word boundary 
untess a length is specified, in which case 
no alignment will occur. The length that 
may pe specified depends on the type of 
expression used for the constant; a length 


cf .1-4 bytes may be used for an absolute 
expression, while a length of only 3 or 4 
may be used for a relocatable or complex 


relocatable expression. 


In the 
generated 


following examples, the field 
from the statement named ACON 
contains four constants, each of which 
occupies four bytes. Note that there is a 
location counter reference in one. The 
value of the location counter will be the 
address of the first byte allocated to the 
fourth constant. The second statement 
shows the same set of constants specified 
as literais (i.e., address constant 
literals). 


Z 
i23) 
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When the location counter reference 
occurs ina literal, as in the LM instruc- 
tion above, the vaiue of the location 
counter is the address of the first byte of 


the instruction. 


Wotes 


Y-Type Address Constant: A Y-type address 
constant has much in common with the A-type 


constant. It too is specified as an abso- 
lute, relocatable, or complex relocatable 
expression. The value of the expression is 
also calculated to 32 bits as explained in 
Section 2. However, the maximum value of 
the expression may be only 215-1. The 
value is then truncated, if necessary, to 
the specified or implied length of the 
field and assembled into the right-most 
bits of the field. The implied length of a 
Y-type constant is two bytes, and alignment 
is to a haif-word boundary unless a length 
is specified, in which case no alignment 
will occur. The maximum length of a Y-type 


address constant is two bytes. If length 
specification is used, a length of two 
pytes may be designated for a relocatable 


or complex expression and .1 to 2 bytes for 
an absolute expression. 
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Warning: Specification of relocatable Y- 
type address constants should be avoided in 
programs destined to be executed on 
machines having more than 32,767 bytes of 
storage capacity. In any case Y-type re- 
locatable address constants should not be 
used in programs to be executed under 
Operating System/360 control. 


S-Type Address Constant: The S-type 
address constant is used to store an 
address in base-displacement form. 





The 
ways: 


constant may be specified in two 


1. As an absolute or relocatable 
sion, e€.q., S(BETA). 


expres- 


2. As two absolute expressions, the first 
of which represents the displacement 
value and the second, the base reg- 
ister, e.g., S(400(13)). 


The address value represented by the 
expression in (1) will be converted by 
the assembler into the proper base register 
and displacement value. An S-type constant 
is assembled as a half word and aligned on 
a half-word boundary. The leftmost four 
bits of the assembled constant represents 
the base register designation, the remain- 
ing 12 bits the displacement value. 


If length specification is used, only 
two bytes may be specified. S-type address 
constants may not be specified as literals. 


Q-Type Address Constant (Assembler F only): 
This constant is used to reserve storage 
for the offset of an external dummy 
section. This offset is added to the 
address of the block of storage allocated 
to external dummy sections to access the 
desired section. The constant is specified 
as a relocatable symbol which has been 
previously defined in a DXD or DSECT state- 
ment. The implied length of a Q-type 
address constant is four bytes and boundary 
alignment is to a full word; a length of 
1-4 bytes may be specified. No bit length 
specification is permitted in a Q-type 
constant. In the following example the 
constant VALUE has been previously defined 
in a DXD or DSECT statement. To access 
VALUE the value of A is added to the base 
address of the block of storage allocated 
for external dummy sections. Q-type ad- 
dress constants may not be specified in 
literals. 





Retin ooo er eee te ye ee ee 
| Name |Cperation |Operand | 
}-------- $------~-~--}-------~------------ 4 
JA jec | Q (VALUE) { 
Looe}. Ai en ce Lostoh oS eee eae Ie J 


v-Type Address Constant: This constant is 
used to reserve storage for the address of 
an external symbol that is used for effect- 
ing branches to other programs. The con- 
stant may not be used for external data 
references within an overlay program. The 
constant is specified as one relocatable 
symbol, which need not be identified by an 
EXTRN statement. Whatever symbol is used is 
assumed to be an external symbol by virtue 
of the fact that it is supplied in a V-type 
address constant. 





To suppress the automatic library call 
mechanism of the linkage editor for a 
constant identified in a V-type address con- 
stant, the programmer can identify it ina 
WXTRN statement (Assembler F only). 


Note that 
operand of a 
constitute a 


specifying a symbol as the 
V-type constant does not 
definition of the symbol for 
this assembly. The implied length of a 
V-type address constant is four bytes, and 
boundary alignment is to a full word. A 
length modifier may be used to specify a 
length of either three or four bytes, in 
which case no such _ boundary alignment 
occurs. In the following example, 12 bytes 
will be reserved, because there are three 
symbols. The value of each assembled con- 
stant will be zero until the program is 
loaded. It must be emphasized that a v- 
type address constant of length less than 4 
can and will be processed by the Assembler 
but cannot be handled by the Linkage Editor. 


(Se Wee ye 1 Sen oma Tae Ga a a 1 
| Name {Operation |Operana | 
eaeaee pene nee {-----------4-~+~-+~+~~------------- 
| VCONST |DC I iSORt MERGE,CALC) | 
bones re oS Ye eee SS eee ee oe J 
DS -- DEFINE STORAGE 

The DS instruction is used to reserve 


areas of Storage and to assign names to 
those areas. The use of this instruction 
is the preferred way of symbolically defin- 
ing storage for work areas, input/output 
areas, etc. The size of a storage area 
that can be reserved by using the DS 
instruction is limited only by the maximum 
value of the location counter. 


wit oe ee ee ee ee 7 
|Name jOperation joperana i 
ae ee ee eh een f--- err nn 
eer sym- ie fOne or more op- | 
, bol or | jerands,separated | 
| blank | by commas, writ— | 
| | {ten in the for- | 
| | |mat described in | 
| | Jthe following | 
| | [text | 
bo bon loe eke hoe Se See ees J 


The format of the DS operand is identi- 
cal to tnat of the DC operand; exactiy the 
same subfields are employed and are written 
in exactly the same sequence as they are in 
the DC operand. Although the formats are 
identical, there are two differences in the 
specification of subfields. They are: 


1. The specification of data (subfield 4) 
is optional in a DS operand, but it is 


mandatory in a DC operand. If the 
constant is specified, it must be 
valid. 

2. The maximum length that may be speci- 


fied for character (C) and hexadecimal 
(X) field types is 65,535 bytes rather 
than 256 bytes. 


If a DS operand specifies a constant in 
subfield 4, and no length is specified in 
subfield 3, the assembler determines the 
length of the data and reserves the 
appropriate amount of storage. It does not 
assemble the constant. The ability to 
specify data and have the assembler calcu- 
late the storage area that would be 
required for such data is a convenience to 


the programmer. If he knows the general 
format of the data that will be placed in 
the storage area during program execution, 


all he needs to do is show it as the fourth 
subfield in a DS operand. The assembler 
then determines the correct amount of stor- 
age to be reserved, thus relieving the 
programmer of length considerations. 


If the DS instruction is named by a 
symbol, its value attribute is the location 
of the leftmost byte of the reserved area. 
The length attribute of the symbol is the 
length (implied or explicit) of the type of 
data specified. Should the DS have a 
series of operands, the length attribute 
for the symbol is developed from the first 
item in the first operand. Any positioning 
required for aligning the storage area to 


the proper type of boundary is done before 
the address value is determined. Bytes 
skipped for alignment are not set to zero. 
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Each field type 
character, floating-point) is 
with certain characteristics (these are 
summarized in Appendix F). The associated 
characteristics will determine which field- 
type code the programmer selects for the DS 
operand and what other information he adds, 
notably a length specification or a 
duplication factor. For example, the E 
floating-point field and the F fixed-point 
field both have an implied length of four 
bytes. The leftmost byte is aligned toa 
full-word boundary. Thus, either code 
could be specified if it were desired to 
reserve four bytes of storage aligned to a 
full-word boundary. To obtain a length of 
eight bytes, one could specify either the E 
or F field type with a length modifier of 
eight. However, a duplication factor would 
have to be used to reserve a larger area, 
because the maximum length specification 
for either type is eight bytes. Note aiso 
that specifying length would cancel any 
special boundary alignment. 


(e.g., hexadecimal, 


associated 


In contrast, packed and zoned decimal (P 
and Z), character (C), hexadecimal (X), and 
binary (B) fields have an implied length of 
one byte. Any of these codes, if used, 
would have to be accompanied by a length 
modifier, unless just one byte is to be 
reserved. Although no alignment occurs, 
the use of C and xX field types permits 
greater latitude in length specifications, 
the maximum for either type being 65,535 
bytes. (Note that this differs from the 
maximum for these types in a DC instruc- 
tion.) Unless a field of one byte is 
desired, either the length must be speci- 
fied for the Cc, X, P, Z, or B field types, 
or else the data must be specified (as the 
fourth subfield), so that the assembler can 
calculate the length. 


To define four 10-byte fields and one 


100-byte field, the respective DS state- 
ments might be as follows: 
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ga aa pcan | 
|Name |Operation [Operand | 
}------ $——--~—=--—- f---------------------- 4 
| FIELD |DS {4CL10 | 
JAREA |DS }CL100 | 
bose 5 Cpe gen eee ae Voatonee sate eee d 


Although FIELD might have been specified 
as one 40-pyte field, the preceding defini- 
tion has the advantage of providing FIELD 
with a length attribute of 10. This would 
be pertinent when using FIELD as a SS 
machine-instruction operand. 


Additional examples of DS statements are 


shown below: 


fo =—= Te SS Re OS Se SES 4 
|Name |Operation| Operand | 


ere faa fn ne 

{ONE {DS |CL80(one 80-byte field, | 
| l | length attribute of 80 | 
|TWwo {DS |80c(80 one-byte fields, | 
| | length attribute of one| 

| THREE|DS |6F(six full words, length| 
| | | attribute of four) | 
[FOUR JDS |D(one double word, length] 
| | | attribute of eight) | 
| FIVE [DS | 4H(four half-words, | 
| | | length attribute of | 
| | | two) | 
Ceska o Renate eee Poe ee ees a ees J 
Note: A DS statement causes the stcrage 
area to he reserved but not set to zeros. 


No assumption should be made as to the 
contents of the reserved area. 


Special Uses of the Duplication Factor 


FORCING ALIGNMENT: The location counter 
can be forced to a double-word, full-word, 
or half-word poundary by using the 
appropriate field type (e.g., D, F, or H) 





with a duplication factor of zero. This 
method may be used to obtain boundary 
alignment that otherwise would not be pro- 


vided. For example, the following state- 
ments would set the location counter to the 
next doubie-word boundary and then reserve 
storage space for a 128-byte field (whose 
leftmost byte would be on a double-word 
boundary). 


Vente ee Te eet ae 1 
{Name {Operation |Operand | 
}----- $---------~- fo--------~------------- { 
| {DS |oD | 
[AREA |DS |CL128 | 
bese Ae Ph SG ke a 4 


DEFINING FIELDS OF AN AREA: A DS instruc- 
tion with a duplication factor of zero can 
be used to assign a name to an area of 
storage without actually reserving the 
area. Additional DS and/or DC instructions 
may then be used to reserve the area and 
assign names to fields within the area (and 
generate constants if DC is used). 








that 80-character 
into an area for 
each record has the 


For example, assume 
records are to be read 
processing and that 
following format: 


Positions 5-10 

Positions 11-30 
Positions 31-36 
Positions 47-54 
Positions 55-62 


Payroll Number 
Employee Name 
Date 

Gross Wages 
Withholding Tax 


The following example illustrates how DS 
instructions might be used to assign a name 
to the record area, then define the fields 
of the area and allocate the storage for 
them. Note that the first statement names 
the entire area by defining the symbol 
RDAREA; the statement gives RDAREA a length 
attribute of 80 bytes, but does not reserve 
any storage. Similarly, the fifth state- 
ment names a six-byte area by defining the 
symbol DATE; the three subsequent state- 
ments actually define the fields of DATE 
and allocate storage for them. The second, 
ninth, and last statements are used for 


spacing purposes and, therefore, are not 
named. 

fe ae Pa er Wei er IA Pe ee 1 
| Name JOperation |Operand | 
poseaees foo 9 ona po nna : 
|RDAREA {DS | OCL80 | 
| |Ds | CL4 | 
{PAYNO {DS | CL6 | 
| NAME | Ds | CL20 | 
| DATE |Ds | OCLE | 
| DAY | Ds [| CL2 | 
[MONTH {DS |CL2 | 
| YEAR {DS {CL2 | 
| [DS |CL1O | 
|GROSS |DS {CL8 | 
|FEDTAX |DS |CL8 | 
| | Ds |cL18 | 
beecens peer enna iS oo eS oe J 
CCW -- DEFINE CHANNEL COMMAND WORD 


The CCW instruction provides a conven- 
ient way to define and generate an eight- 
byte channel command word aligned at a 
double-word boundary. CCW will cauSe any 
bytes skipped to be zeroed. The internal 
machine format of a channel command word is 
shown in Table 5-1. 


Table 5-1. Channel Command Word 
aie TS Tes Pee ee eee Se 1 
[Byte | Bits | Usage | 
}----- }------- }-—-~~-----------------~~--- { 
|1 | 0-7 | Command code | 
[2-4 | 8-31 | Data address | 
|5 | 32-36 | Flags | 
| {| 37-39 | Must be zero | 
[6 | 40-47 | Set to zero | 
17-8 | 48-63 | Count | 
(aaa Pee oS dh SSS Se SS ee eee Sees J 
The format of the CCW instruction 


statement is: 


 oaeiedeinaiaa aes Teo ey Toe ee 
| Name ] Operation |Operand 

}-------- $---------4---------------------- 
{Any sym-|CCW {Four operands, 

Jbol or | |separated by commas, 

| blank 


| 

| jtents of the channel 
| {command word in 

| {the format 

{ {described in the 
| 
1 


7 
| 
4 
| 
| 
{specifying the con- | 
| 
| 
| 
| 
[following text | 

J 


All four operands must appear. They are 
written, from left to right, as follows: 


1. An absolute expression that specifies 
the command code. This expression's 
value is right-justified in byte 1. 


2. An expression specifying the data 
address. This value is treated as a 
3-byte A-type constant. The value of 


this expression is in bytes 2-4. 


3. An ansolute expression that specifies 
the flags for bits 32-36 and zeros for 
bits 37-39. The value of this expres- 


sion is right-justified in byte 5. 
(Byte 6 is set to zero.) 
4. An anpsolute expression that specifies 


the count. The value of this expres- 
Sion is right-justified in bytes 7-8. 


The following is an example of a ccW 
statement: 
eats Tren we Ge a 1 
|Name |Operation |Operand | 
}-----4----------- 4----------------------- { 
| jccw | 2,READAREA, X'48', 80 | 
Loess E Bal aetna ae ea oar te ea a ee re 4 


Note that the form of the third operand 
sets bits 37-39 to zero, as required. The 
bit pattern of this operand is as follows: 
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0100 1000 
If there is a symbol in the name field 
of the CCW instruction, it is assigned the 


address value of the leftmost byte of the 
channel command word. The length attribute 
of the symbol is 8. 


LISTING CONTROL INSTRUCTIONS 


The listing control instructions are 
used to identify an assembly listing and 
assembly output cards, to provide blank 


lines in an assembly listing, and to desig- 
nate how much detail is to be included in 
an assembly listing. In no case are 
instructions or constants generated in the 
object program. Listing control statements 
with the exception of PRINT are not printed 
in the listing. 


NOTE: TITLE, SPACE, and EJECT statements 
will not appear in the source listing 
unless the statement is continued onto 
another card. Then the first card of the 
statement is printed. However, any of 
these three types of statements, if 
generated as macro instruction expansion, 
will never be listed regardless of 
continuation. 


TITLE -- IDENTIFY ASSEMBLY OUTPUT 


The TITLE instruction enables the pro- 
grammer to identify the assembly listing 
and assembly output cards. The format of 


the TITLE instruction statement is as fol- 
lows: 

ae tee pee tS Ser SS SS Se See See 
| Name | Operation i Operand | 
woo ------ jeoo------- be - --  enn 
' Special, | TITLE A sequence of char- | 
sequence | | acters, enclosed in 
lor vari- |} | apostrophes | 
| able sym-| | 
, Pol or | \ 
; blank { I 1 
fe a ee he ee ee Loew eee ee ee ee 4 


The name field may contain a special 
symbol of from one to four alphabetic or 
numeric characters in any combination. The 
contents of the name field are punched into 
columns 73-76 of all the output cards for 
the program except those produced by the 
PUNCH and REPRO assembler instructions. 
Only the first TITLE statement in a program 
may have a special symbol or a variable sym- 
bol in the name field. The name field of 
all subsequent TITLE statements must contain 
either a sequence symbol or a blank. 


Assembler Instruction Statements 51 


The operand field may contain up to 100 
characters enclosed in apostrophes. Spe- 
cial consideration must be given to rep- 
resenting apostrophes and ampersands as 
characters. Fach single apostrophe or 
ampersand desired aS a character in the 
constant must be represented by a pair of 
apostrophes or ampersands. Only one apos- 
trophe or ampersand appears in storage. 
Tne contents of the operand field are 
printed at the top of each page of the 
assembly Listing. 


A program may contain more than one 
TITLE statement. Each TITLE statement pro- 
vides the heading for pages in the assembly 
listing that follow it, until another TITLE 
statement is encountered. Each TITLE 
statement causes the listing to be advanced 


to a new page (before the heading is 
printed). 
For example, if the following statement 


is the first TITLE statement to appear ina 
program: 


Pacts = Tea ee ee he te ae Ge 1 
{Name |Operation |Operand | 
}-----— $-------—-—~ $--~-----~------------- { 
jPGMi |TITLE | "FIRST HEADING! 

bese S We ole ee Me ee J 


then PGM1 is punched into all of the output 
cards (columns 73-76) and this heading 
appears at the top of each subsequent page: 
PGM] FIRST HEADING. 


If the following statement occurs later 
in the same program: 


ie Me fie wae ey ee i ee 1 
{Name |Operation {|Operand | 
pra----} --------~--f---- === --- === ----- { 
i | TITLE |'A NEW HEADING! | 
es tS See el Sits ce ee Bese AE J 
then, PGML is still punched into the output 
cards, but each following page begins with 


the heading: PGM1l A NEW HEADING. 





Note: The sequence number of the cards in 
the output deck is contained in columns 
77-80. 
EJECT -- START NEW PAGE 

The EJECT instruction causes the next 


line of the listing to appear at the top of 
anew page. This instruction provides a 
convenient way to Separate routines in the 
program listing. The format of the EJECT 
instruction statement is as follows: 


52 


xe by Ate ep Te say hese eee ony eee ely, 7 
| Name | Operation | Operand | 
i ai Len a a a ee pee ee ~~ -- 4 
la se- | EJECT | Not used; should be | 
iquence | blank 
' symbol | \ | 
! or blank | i l 
[nee ee are pS a a ara A Sse See 4 
If the line before the EJECT statement 
appears at the bottom of a page, the EJECT 


statement has no effect. Two EJECT state- 
ments may be used in succession to obtain a 
blank page. A TITLE instruction followed 
immediately by an EJECT instruction will 
produce a page with nothing but the operand 
entry (if any) of the TITLE instruction. 
Text following the EJECT instruction will 
begin at the top of the next page. 


SPACE -- SPACE LISTING 


The SPACE instruction is used to insert 


one or wore biank lines in the listing. 
The format of the SPACE instruction state- 
ment is as follows: 
CES ae SE aR Se ee a eS OR EN Tee eee 7 
| Name | Operation | Operand H 
--------- }-----+--~+-~4--------~-----~-------4 
| A se- | SPACE A decimal value 
| quence | ; or blank | 
symbol | | i 
, or blank | { i 
Me as ie a See eS ai Sh a ed ah ck SS a Se a sa oa =) 


A decimal value is used to specify the 
number of blank lines to be inserted in the 
assembly listing. A blank operand causes 
one plank line to be inserted. If this 
value exceeds the number of lines remaining 
on the listing page, the statement will 
have the same effect as an EJECT statement. 


PRINT -- PRINT OPTIONAL DATA 


The PRINT instruction is used to control 


printing of the assembly Listing. The 
format of the PRINT instruction statement 
is: 

aie as kag Gav ese ts Toe eS eS SS StS SS SS= 7 
| Name t Operation | Operand | 
[------~-- Paosthecous We cere SSeS See 
1A se- | PRINT | One to three | 
| quence ! operands 
i symbol | | | 
for blank , | | 
bes es Se i ah eae is dee ede ee ee za) 


The one to three operands may include an 
operand from each of the following groups 
in any sequence: 


1. ON ~ A listing is printed. 


OFF ~ No listing is printed. 


2. GEN - All statements generated by 
macro-instructions are print- 
ed. 

NOGEN - Statements generated by macro- 
instructions are not printed 
with the exception of MNOTE 
which will print regardless of 
NOGEN. However, the macro- 
instruction itself will appear 
in the listing. 


3. DATA - Constants are printed out in 


full in the listing. 
NODATA - Only the leftmost eight bytes 
are printed on the listing. 


A program may contain any number of 
PRINT statements. A PRINT statement con- 
trols the printing of the assembly listing 
until another PRINT statement is encoun- 
tered. Each option remains in effect 
until the corresponding opposite option is 
specified. 


Until the first PRINT statement (if any) 
is encountered, the following is assumed: 


For example, if the statement: 


(RS Bae ee See SS aS 1 
| Name iOpevetion \Oserend | 
f------ $-----------}---------------------- { 
| }pc |xL256" oo | 
bee SS ee ee Eee Re a ne RE 4 


appears in a 
are assembled. 


program, 256 bytes of zeros 
If the statement: 


GR a SSS ss 1 
|Name {Operation operand | 
|------}-----------}---------------------- { 
| ee | DATA | 
Vitae see DS i ete BS ee et 4 
is the last PRINT statement to appear 


before the DC statement, all 256 bytes of 
zeros are printed in the assembly listing. 
However, if: 
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[Name JOperation jOpetana | 
}------ fomnn nn nnn a pow a= === { 
| | PRINT [NODA | 
(SShs52 he So Se Da Se J 
is the last PRINT statement to appear 


before the DC statement, only eight bytes 
of zeros are printed in the assembly list- 
ing. 


Whenever an operand is omitted, it is 
assumed to be unchanged and continues 
according to its last specification. 


The hierarchy of 
ments is: 


print control state- 


1. ON and OFF 
2. GEN and NOGEN 


3. DATA and NODATA 


Thus with the following statement nothing 
would be printed. 
Ses Se eee Sa a eS A 
|Name |Operation toperand | 
[------}-~-----~---}-----------~---------- : 
{ (eee iene DATA, GEN | 
(set tb hd ee ee Se 3 
PROGRAM CONTROL INSTRUCTIONS 

The program control instructions are 


used to specify the end of an assembly, to 
set the location counter to a value or word 
boundary, to insert previously written cod- 
ing in the program, to specify the place- 
ment of literals in storage, to check the 
sequence of input cards, to indicate state- 


ment format, and to punch a card. Except 
for the CNOP and COPY instructions, none of 
these assembler instructions generate 
instructions or constants in the object 
program. 

IcTL -- INPUT FORMAT CONTROL 


The ICTL instruction allows the program- 
mer to alter the normal format of his 
source program statements. The ICTL state- 
ment must precede all other statements in 
the source program and may be used only 
once. The format of the ICTL instruction 
statement is as follows: 
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ae aaa To See (SS RSS SR Sra Se a) 
ioe heeaae canons : 
[plank |ICTL ji-3 decimal self-de- 

i | | fining values of the 
boceucse. Poo oe sform bee, j 


Operand b specifies the begin column of 
the source statement. It must always be 
specified, and must be within 1-40, inclu- 
sive. Operand e specifies the end column 
of the source statement. The end column, 
when specified, must be within 41-80, in- 
clusive; when not specified, it is assumed 
to be 71. The end column must not be less 
than the begin column +5. The column after 
the end column is used to indicate whether 
the next card is a continuation card. 
Operand c specifies the continue column of 
the source statement. The continue column, 
when specified, must be within 2-40 and 
must be greater than b. If the continue 
column is not specified, or if column 80 is 
specified as the end column, the assembler 
assumes that there are no continuation 
cards, and all statements are contained on 
a single card. The operand forms b,,c and 
b, are invalid. 


used in the 
that 
and 


statement is 
the assembler assumes 
are the begin, end, 
respectively. 


Ir no IcTL 
source program, 
1, 71, and 16 
continue columns, 


The next example 
column as column 25. 


designates the begin 
Since the end column 


is not specified, it is assumed to be 
column 71. No continuation cards are rec- 
ognized because the continue column is not 
specified. 

 Seeietaeas Ts a cm iain 1 
[Name |Operation |Operand | 
{----~-4---------- --4--+--—----+---+--+--+----- 4 
| | IcTL |25 | 
(re Wc oe eb SS bess sos eee tlle LoL J 
ISEQ -- INPUT SEQUENCE CHECKING 

The ISEQ instruction is used to 


check the sequence of input cards. (A 
sequence error is considered serious, but 
the assemoly is not terminated.) The 
format of the ISEQ instruction statement 
is as follows: 

r ina Lose oe Ve pe ee ee 1 


Name |Operation |Operand | 

wan fe en ee fn ec eragrn 4 
7 Two decimal self-de- 

Blank|ISE 

| - : 2 | €ining values of the 

t_--._4__..______-1form_l,ri_or_ blank _____ J 


The operands 1 and yr, respectiveiy, 
Specify the leftmost and rightmost columns 


of the field in the input cards to ve 
checked. Operand r must be equal to or 
greater than operand 1. Columns to be 
checked must not be between the begin ana 


end columns. 


Sequence checking begins with the first 
card following the ISEQO statement. Compar- 
ison of adjacent cards makes use of the 
eight-bit internal collating sequence. 
(See Appendix A.) Each card checked must 
be higher than the preceding card. 


An ISEQ statement with a plank operand 
terminates the operation. (Note that this 
ISEQ statement is also sequence checked.) 
Checking may be resumed with another ISEQ 
statement. 


Sequence checking is only performed on 
statements contained in the source program. 
Statements inserted by the COPY assemuler- 
instruction or generated by a macro- 
instruction are not checked for sequence. 
Also macro-definitions in a macro library 
are not checked. 


PUNCH -- FPUNCH A CARD 


The PUNCH assembler-instruction causes 
the data in the operand to be punched into 
a card. One PUNCH statement produces one 
punched card. As many PUNCH statements may 
be used aS are necessary. The format is: 


fares ers Toe ee ee 1 
| Name {Operation |Operand | 
poo-ao--$-----------4--------------------- : 
jp PcSet.. ppuNeH j1 to 80 characters | 
| pared | Jenclosed in apos- | 
| ane ! [Stophe | 
| 
(eisai Beane ere (eee actetetscae Serko aT 
Using character representation, the 


operand is written as a string of up to 80 
characters enclosed in apostrophes. All 
characters, including blank, are valid. 
The position immediately to the right of 
the left apostrophe is regarded as column 
one of the card to be punched. Substitu- 
tion is verformed for variable symbols in 
the operand. Special consideration must be 


given to representing apostrophes and 
ampersands as characters. Each apostrophe 
or ampersand desired as a character in the 


constant must be represented py a pair of 
apostrophes or ampersands. Only one apos- 
trophe or ampersand appears in storage. 


PUNCH statementS may occur anywhere 
within a program, except before macro defi- 
nitions. They may occur within a macro 


definition but not between the end orf a 


macro definition 
next macro definition. If a PUNCH state- 
ment occurs before the first control sec- 
tion, the resultant card will precede ail 
other cards in the object program card 
deck; otherwise the card will be punched in 
place. No sequence number or identifi- 
cation is punched in the card. 


REPRO -- REPRODUCE FOLLOWING CARD 


The REPRO assembler-instruction causes 
data on the followina statement line to be 
punched into ae ecard. The data is not 
processed; it is punched in a card, and no 
substitution is performed for variable sym- 


pols. No sequence number or identification 
is punched on the card. One KEPRO instruc- 
tion produces one punched card. The REPRO 


instruction may not appear before a macro 
definition. REPRO statements that occur 
before all statements composing the first 


or only control section will punch cards 
which precede all other cards of the object 


deck. The format is: 
(te ia eee ee Brae ont eae ae a ee T 
| Name | Operation | Operand t 
--~--~----- +----------- 4-------------------- 4 
lA se- | REPRO | Blank 
' quence |! i | 
| symbol | | 
or blank | i 
Seoul ey Vins ate eo oe ee teal 
The line to be reproduced may cohtain 


any combination of up to 80 valid charac- 
ters. Characters may be entered starting 
in column 1 and continuing through colunn 
80 of the Line. Column 1 of the line 
corresponds to column 1 of the card to be 
punched. 


ORG -- SET LOCATION COUNTER 


The ORG instruction is used to alter the 


setting cf the location counter for the 
current control section. The format of the 
ORG instruction statement is: 
ee Aa eg Pao a eg SOO Ty eS a Te = 
| Name Joperation lOperana | 
ba pert tecccccc ccc o pecan eee cee { 
Vee | ORG JA relocatable ex- | 
am 
| symbol ; TRESS ion or blank 
I Sank | | 
beesse ce Lseweuteee lee Jose cee se seee es = 
Any symbols in the expression must have 
been previously defined. The unpaired 
relocatable symool must be defined in the 
same control section in which the ORG 


statement appears. 
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and the beginning of the” 


The location counter is set to the value 
of the expression in the operand. If the 
operand is omitted, the location counter is 
set to the next available (unused) location 
for that control section. 


An ORG statement cannot be used to 
specify a location below the beginning of 
the control section in which it appears. 
The following is invalid if it appears less 
than 500 bytes from the beginning of the 
current control section since it will give 
the location counter a value larger than it 
can handle. 


If it is desired to reset the location 
counter to the next available byte in the 
current control section, the following 
statement would be used: 


If previous ORG statements have reauced 
the location counter for the purpose of 
redefiring a portion of the current control 
section, an ORG statement with an omitted 
operand can then pe used to terminate the 
effects of such statements and restore the 
location counter to its highest setting: 


Note: Through use of the ORG statement two 
instructions may be given the same location 
counter values. In such a case the second 
instruction will not always eliminate the 
effects of the first instruction. Consider 
the following example: 





ADDR pc A(LOC) 
ORG *«-4 
B DC C'BETA' 


In this example the value of B (BETA) will 
be destroyed by the relocation of ADDR 
during linkage editing. 


LTORG -- BEGIN LITERAL POOL 


The LTORG instruction causes all liter- 
als since the previous LTORG (or start of 
the program) to be assembled at. appropriate 


boundaries starting at the first double- 
word boundary following the LTORG 
Statement. If no literals follow the LTORG 


alignment of the next instruc- 

not a LTORG instruction) 
Bytes skipped are not zeroed. 
state- 


statement, 
tion (which is 
will occur. 
The format of the LTORG instruction 
ment is: 
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(SSeS sess Toe Oe To SS ie eae ee 1 
bie [Operation |Operand | 
rar a i pe i na re, = St a lg iS Sein Sud 4 
[Symbol {|LTORG |Not used | 
jor | \ | 
| blank | | | 
Lobes so Pooh Se ESV Ses e Slo a J 


The symbol represents the address of the 
first byte of the literal pool. It has a 
length attribute of 1. 


The literal pool is organized into four 
segments within which the literals are 
stored in order of appearance, dependent on 
the divisibility properties of their object 
lengths (dup factor times total explicit 
or implied length). The first segment 
contains all literals whose object length 
is a multiple of eight. Those remaining 
laterals with lengths divisible by four 
are stored in the second segment. The 
third segment holds the remaining even- 
length literals. Any literals left over 
have odd lengths and are stored in the 
fourth segment. 


Since each literal pool begins at a 
double-word boundary, this guarantees that 
all segment one literals are double-word, 
segment two full-word, and segment three 
half-word aligned, with no space wasted 
except, possibly, at the pool origin. 


Literals from the following statement 
are in the pool, in the segments indicated 
by the circled numbers, where @) means 
multiple of eight, etc., 


MVC A(12),=3F'lL' @ 
AD 2,=D'1' 
SD 3,=2F'1,2! 
IC 2,=xXL1'1! ® 
AD 2,=D'2! 


Special Addressing Consideration 





Any literals used after the last LTORG 
Statement in a program are placed at the 
end of the first control section. If there 
are no LTORG statements in a program, all 
literais used in the program are placed at 
the end of the first control section. In 
these circumstances the programmer must 
ensure that the first control secticn is 
always addressable. This means that the 
base address register for the first control 
section should not be changed through usage 
in subsequent control sections. If the 
programmer does not wish to reserve a 
register for this purpose, he may place a 
LTORG statement at the end of each control 
section thereby ensuring that all literals 
appearing in that section are addressable. 
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Duplicate Literals 


If duplicate literals occur within the 
range controlled by one LIORG statement, 
only one literal is stored. Literals are 
considered duplicates only if their speci- 
tications are identical. A literal will be 
stored, even if it appears to duplicate 
another literal, if it is an A-type address 
constant containing any reference to the 
location counter. 


The following examples illustrate how 
the assembler stores pairs of literals, if 
the placement of each pair is controlled by 
the sani LTORG statement. 


X'FO' 
poth are stored 
(ers Oey 
XL3°"O° 
Both are stored 
HL3*O' 
AC *+4) 
Both are stored 
A(¥+4) 
X'FFFF' 
Identical; the first is stored 
X'PFFF'* 
CNOP -- CONDITIONAL NO OPERATION 


The CNOP instruction allows the program- 


mer to align an instruction at a specific 
half-word boundary. If any bytes must be 
skipped in order to align the instruction 


properly, the assembler ensures an unbroken 
instruction flow by generating no-operation 
instructions. This facility is useful in 
creating calling sequences consisting of a 
linkage to a subroutine followed by parame- 
ters such aS channel command words (CCW). 


The CNOP instruction ensures the align- 
ment of the location counter setting to a 
half-word, word, or double-word boundary. 
if the location counter is already properly 
aligned, the CNOP instruction has no 
effect. If the specified alignment 
requires the location counter to be incre- 
mented, one to three no-operation instruc- 
tions are generated, each of which uses two 
bytes. 


The format of the CNOP instruction 
statement is as follows: 
aaa mates: arent ase es Sate i eo 1 
|Name |Operation |Overand | 
byowgi--t----- $-=------------------- 4 
| hes | CNOP |Two absolute | 
ja een | |expressions of | 
symbol ‘ 
Bee | jthe form b,w [ 
ees | | | 
ank 
pica Ncasane Baoan dettolelelnialelhalerg gies e l 


Figure 5-6. CNOP Alignment 


Any symbols used in the expressions in 
the operand field must have been previously 
defined. 


Operand b specifies at which byte ina 
word or double word the location counter is 
to be set; b can be 0, 2, 4, or 6. Operand 
w specifies whether byte b is in a word 
(w=4) ox double word (w=8). The following 
pairs of b and w are valid: 


b,w Specifies 

0,4 Beginning of a word 

2,4 Middle of a word 

0,8 Beginning of a double word 

2,8 Second half word of a double word 

4,8 Middle (third half word) of a dou- 

ble word 

6,8 Fourth half word of a double word 

Figure 5-6 shows the position in a 


double word that each of these pairs speci- 
fies. Note that both 0,4 and 2,4 specify 
two locations in a double word. 


Assume that the location counter is 
currentiy aligned at a double-word bounda- 
ry- Then the CNOP instruction in this 
sequence: 

RR eras ier eeeiastar ae said a Too ss eS a ee 
| Name Operation | OQperand | 
[------}----------- f~---=-----~=-----~--~- 1 
| | CNOP {0,8 | 
| | BALR |2,14 { 
bosses bests aaa Sa es Domebs polos o tS J 
has no effect; it is merely printed in the 


assembly listing. However, this sequence: 
cam ade oad Tess oe Se a eS 1 
|Name |Operation joperand H 
}------ +----------- 4---------------------- { 
| | CNOP 16,8 | 
| | BALR {2,14 | 
a Ser S Eneeae cee aera en deerme ee Ces Se SS J 
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er at ER erp SS oe BO RS NE Se Se ee Fe ae 4 
Word | 
--------------------- qy---------=-----------4 
Half Word | Half Word | 
~-=------- qn----7---- f= - === === ---=------4 
Byte | Byte | Byte | Byte | 

he er RS ne 4---~--~---1--~~------] 
0,4 2,4 | 
4,8 6,8 I 
4 

causes three branch-on-conditions 


(no-operations) to be generated, thus 
aligning the BALR instruction at the last 
half-word in a double word as follows: 


Pan a ToS ees SS Se 
| Name joperation {Operand | 
}------+----------- }------------------~-~- 1 
| {BCR j0,0 
| | BCR 10,0 | 
| | BCR {0,0 
| | BALR J2,14 | 
bono PoP See ee Se Pes te ht DO ee a J 


After the BALR instruction is generated, 
the location counter is at a doubie-word 
boundary, thereby ensuring an unbroken 
instruction flow. 


COPY -- COPY PREDEFINED SOURCE CODING 


The COPY instruction obtains source- 
language coding from a library and includes 
it in the program currently being 
assembled. The format.of the COPY instruc- 
tion statement is as follows: 


The operand is a symbol that identifies 
a partitioned data set member to be copied 
from either the system macro library or a 
user library concatenated to it. Insert- 
ing code in the library to be copied later 
is performed by the IEUPDAT or IEUPDTE 
routines, details of which are covered in 


the §/360 Operating System Utilities, 
Form C28-6586., 


The assembler inserts the requested cod- 
ing immediately after the COPY statement 
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is encountered. The requested coding may 
not contain any COPY, END, ICTL, ISEQ, 
MACRO, or MEND statements. 


If identical COPY statements are encoun- 
tered, the coding they request is brought 
into the orogram each time. All statements 
included in the program via COPY are proc- 
essed using the standard format regardless 
of any ICTL instructions in the program. 
(For a further discussion of COPY see 
Section 7.) 


END -- END ASSEMBLY 


The END instruction terminates the 
assembly of a program. It may also desig- 
nate a point in the program or in a 
separately assembled program to which con- 
trol may be transferred after the program 
is loaded. The END instruction must always 
be the last statement in the source ovro- 
gram. A literal may not be used. If an 
external symbool is used in the expression, 
the value of the expression must be 0. 


The format of the END instruction state- 
ment is as follows: 


oa Tee See ee ee a 
JOperation |Operand | 
+ 

[END 


f 
| Blank [A relocatable ex- | 


| pression or blank | 
bee seces Wise ee a Leena levee Se Sa J 


The operand specifies the point to which 


control may be transferred when loading is 


complete. This point is usually the first 
machine-instruction in the program, as 
shown in the following sequence. 


[a Tt ree Ne a eet ge ON ae, 1 
| Name [Operation |Operand | 
}-------}----------- $-----~--------------- { 
| NAME |CSECT | | 
J AREA {Ds p50F | 
|BEGIN |BALR }2,0 | 
! | USING j*,2 | 
i | - | | 
i | - | | 
i is I I 
| | END | BEGIN | 
beg eeSewy dC neon vere eee Wes chess os eat SE Se J 
NOTE: Editing errors in system macro 


definitions (macro definitions included 

in a macro library) are discovered when 
the macro definitions are read from the 
macro library. This ‘occurs after the END 
statement has been read. They will there- 
fore be flagged after the END statement. 

If the programmer does not know which of 
his system macros caused an error, it is 
necessary to punch all system macro defi- 
nitions used in the program, including 
inner macro definitions, and insert them 

in the source program as programmer macro 
definitions, since programmer macro defini- 
tions are flagged in-line. To aid in 
debugging it is advisable to test all macro 
definitions as programmer macro definitions 
before incorporating them in the library as 
system macro definitions. 


PART II -- THE MACRO LANGUAGE 


SECTION 6: INTRODUCTION TO THE MACRO LANGUAGE 


SECTION 7: HOW TO PREPARE MACRO DEFINITIONS 


SECTION 8: HOW TO WRITE MACRO INSTRUCTIONS 


SECTION 9: HOW TO WRITE CONDITIONAL ASSEMBLY INSTRUCTIONS 


SECTION 10: EXTENDED FEATURES OF THE MACRO LANGUAGE 


SECTION 6: _IN 


The Operating System/360 macro language 
is an extension of the Operating System/360 
assembler language. It provides a conven- 
ient way to generate a desired sequence of 
assembler language statements many times in 
one or more programs. The macro-definition 
is written only once, and a Single state- 
ment, a macro instruction statement, is 
written each time a programmer wants to 
generate the desired sequence of state- 
ments. 


This facility simplifies the coding of 
programs, reduces the chance of programming 
errors, and ensures that standard sequences 


of statements are used to accomplish 
desired functions. 

An additional facility, called condi- 
tional assembly, allows one to code state- 
ments which may or may not be assembled, 
depending upon conditions evaluated at 
assembly time. These conditions are usual- 
ly tests of values, which may be defined, 
set, changed, and tested during assembly. 


The conditional assembly facility may be 
used without using macro instruction state- 
ments. 


THE MACRO INSTRUCTION STATEMENT 





A macro instruction statement (hereafter 
called a macro instruction) iS a source 
program statement. The assembler generates 
a sequence of assembler language statements 
for each occurrence of the same macro 
instruction. The generated statements are 
then processed jlike any other assembler 
language statement. 


Macro instructions can be tested by 
placing them before the assembly cards of a 
test program. 


Three types of macro instructions may be 
written. They are positional, keyword, and 
mixed-mode macro instructions. Positional 
Iacro instructions permit the programmer to 
write the operands of a macro instruction 
in a fixed order. Keyword Macro 
instructions permit the programmer to write 
the operands of a macro instruction in a 
variable order. Mixed-mode macro 
instructions permit the programmer to use 
the features of both positional and keyword 
macro instructions in the same macro 
instruction. 
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INTRODUCTION TO THE MACRO LANGUAGE 





THE MACRO DEFINITION 


A macro definition is a set of 
statements that provides the assempler 
with: (1) the mnemonic operation code and 
the format of the macro instruction, and 
(2) the sequence of statements the assemn- 
bler generates when the macro instruction 
appears in the source program. 


Every macro definition consists of a 
macro definition header statement, a macro 


instruction prototype statement, one or 
more model statements, COPY statements, 
MEXIT, MNOTE, er conditional assemply 


instructions, and a macro definition trail- 
er statement. 


The macro definition header and trailer 
statements indicate to the assembler the 
beginning and end of a macro definition. 


The macro instruction prototype state- 
ment specifies. the mnemonic operation code 
and the type of the macro instruction. 


The model statements are used by the 
assembler to generate the assembler lan- 
guage statements that replace each occur- 
rence of the macro instruction. 


The COPY statements nay be used to copy 
model statements, MEXIT, MNOTE or  condi- 
tional assembly instructions from a system 
library into a macro definition. 


The MEXIT instruction can be used to 
terminate processing of a macro definition. 


The MNOTE instruction can be used to 
generate an error message when the rules 
for writing a particular macre instruction 
are violated. 


The conditional assembly instructions 
may be used to vary the sequence of state- 
ments generated for each occurrence of a 


macro instruction. Conditional assempoly 
instructions may also be used outside 
macro definitions, i.e., among the assem- 


bler language statements in the prograni. 


THE MACRO LIBRARY 


The same macro definition may be made 
available to more than one source program 
by placing the macro definition in the 
Macro library. The macro jlibrary is a 
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collection of macro definitions that can be 
used by all the assenbler larguage programs 


in an installation. Once a macro 
definition has been placed in the macro 
library it may be used by writing its 


corresponding macro instruction in a source 
program. Macro definitions must be in the 
system macro library under the same name as 
the prototype. The procedure for placing 
macro definitions in the macro library is 
described in the Utilities publication. 





A macro definition included in a source 
deck is called a programmer macro defini- 


tion. One residing in a macro library is 
called a system macro definition, There 
is no difference in function. If a pro- 


grammer macro is included in a macro 
library it becomes a system macro defini- 
tion, and if a system macro definition is 
punched and included in a source deck it 
becomes a programmer macro definition. 


System and programmer macros will be 
expanded the same, but syntax errors are 
handled differently. In programmer macros, 
error messages are attached to the state- 
ments in error. In system macros, however, 
error messages cannot be asscciated with 
the statement in error because these macros 
are located and edited after the entire 
source deck has been read. Therefore, the 
error messages are associated with the END 
statement. 


Because of the difficulty of finding 
syntax errors in system macros, a macro 
definition should be run and "debugged" as 
a programmer macro before it is placed ina 
macro library. 


SYSTEM MACRO INSTRUCTIONS 


The macro instructions that correspond 
co macro definitions prepared by IBM are 
called system macro instructions. System 
macro instructions are described in IBM 
System/360 Operating System Supervisor 
and Data Management Macro Instructions 
(GC28-6647). 
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VARYING THE GENERATED STATEMENTS 


Each time a macro instruction appears in 
the source program it is replaced by the 
same sequence of assembler language 
statements. Conditional assembly instruc- 
tions, however, may be used to vary the 
number and format of the generated state- 
wents. 


VARIABLE SYMBOLS 


A variable symbol is a type of symbol 
that is assigned different values by either 
the programmer or the assembler. When the 
assemoler uses a macro definition to deter- 
mine what statements are to replace a 
macro instruction, variable symbols in the 
model statements are replaced with the 
values assigned to them. By changing the 
values assigned to variable symbols the 
programmer can vary parts of the generated 
statements. 


written aS an 
through 


A variaple symbol is 
ampersand followed by from one 


seven letters and/or digits, the first of 
which must be a letter. Elsewhere, two 
ampersands must be used to represent an 
ampersand. 


Types of Variable Symbols 





variable sym- 
system variable 
The SET symbols 


There are three types of 
bols: symbolic parameters, 
symbols, and SET symbols. 
are further broken down into SETA symbols, 
SETB symbols, and SETC symbols. The three 
types of variable symbols ditfer in the way 
they are assigned values. 


Assigning Values to Variable Symbols 


Symbolic parameters are assigned values 
by the programmer each time he writes a 
macro instruction. 


System variable symbols are assigned 
values by the assembler each time it proc- 
esses a macro instruction. 


SET symbols are assigned values by the 
programmer by means of conditional assembly 
instructions. 


Global SET Symbols 


The values assigned to SET symbols in 
one macro definition may be used to vary 
the statements that appear in other macro 
definitions. All SET symbols used for this 
purpose must be defined by the programmer 
as global SET symbols. All other SET 
symbols (i.e., those which may be used to 
vary statements that appear in the same 
macro definition) must pe defined by the 
programmer as local SET symbols. Local SET 
symbols and the other variable symbols 
(that is, symbolic paraneters and system 
variable symbois) are local variable 
symbols. Global SET symbols are global 
variable symbols. 
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ORGANIZATION OF THIS PART OF THE 
PUBLICATION 


Sections 7 and 8 describe the pasic 
rules for preparing macro definitions and 
for writing macre instructions. 

Section 9 describes the rules for writ- 
ing conditional assembly instructions. 


Section 10 describes additional features 
of the macro language, including rules for 
defining global SET symbols, preparing key- 
word and mixed-mode macro definitions, and 
writing keyword and mixed-rode macro 
instructions. 


Appendix G contains a reference summary 
of the entire macro language. 


Examples of the features of the language 


appear throughout the remainder of the 
publication. These examples illustrate the 
use of particular features. However, they 


are not meant to show the full 
of these features. 


versatility 
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A macro definition consists of: 


1. A macro definition header statement. 


2. A macro instruction prototype state- 
ment. 

3. Zero or more model statements, COPY 
statenents, MEXIT, MNOTE, or 


conditional assembly instructions. 
4. A macro definition trailer statement. 


Except for MEXIT, MNOTE, and conditional 
assembly instructions, this section of the 
publication describes all of the statements 
that may be used to prepare macro 
definitions. Conditional assembly 
instructions are described in Section 9. 
MEXIT and MNOTE instructions are described 
in Section 10. 


Macro definitions appearing in a source 
oregram must appear before all PUNCH and 
REPRO statements and all statements which 
pertain to the first control section. 
Specifically, only the listing control 
instructions (EJECT, PRINT, SPACE, and 
TITLE), OPSYN, ICTL, and ISEQ instructions, 
and comments statements can occur before 
the macro definitions. All but the ICTL 
and OPSYN instruction can appear between 
macro definitions if there is more than 
one definition in the source program. 
Conditional assembly, substitution, and 
sequence symbols cannot be used in front of 
or between macro definitions. 


A macro -definition cannot appear within 
a macro definition and the maximum number 
of continuation cards for a macro definition 
statement is two. 


MACRO -- MACRO DEFINITION HEADER 

The macro definition header statement 
indicates the beginning of a macro 
definition. It must be the first statement 


in every macro definition. 
this statement is: 


The format of 


igiee pers AR a Sa a a a a al aR | 

| Name |Operation |Operand { 
~=-=--- $--~----~---}~=-------------------{ 
{Blank |MACRO | Blank | 
Loo x Cee ees eee A ee See ee Sas J 
MEND -- MACRO DEFINITION TRAILER 


The macro definition trailer statement 
indicates the end of a macro definition. 
It can appear only once within a macro 


SECTION 7: HOW TO PRFPARE MACRO DEFINITIONS 


definition and must be the last statement 
in every macro definition. The format of 
this statement is: 


T Te ag ee Pg ee 1 
| Name [Operation [Operand i 
ae nna pen }--------------------- { 
| aa | MEND | 8lank | 

nce 

| symbol | | | 
is aaa | | 
blank | | | 
 KepSeBen: BAS: Meee ea Ped eno OD sda aoe et a 

MACRO INSTRUCTION PROTOTYPE 


The macro instruction prototype state- 
ment (hereafter called the prototype 
statement) specifies the nnemonic operation 
code and the format of all macro 
instructions that refer to the macro 
definition. It must be the second state- 
ment of every macro definition. The format 
of this statement is: 


ay aaa Tos SSS To Pee 1 
{Operation {Operand | 
}------------ }---------- 4------~---------- : 
|A symbolic |A symbol [One or more sym- | 
|parameter {bolic parameters | 
jor blank | separated by com-] 
mas, or an 

| blank | 


Th: symbolic parameters are used in the 
macre definition to represent the name 
field and operands of the corresponding 
macro instruction. A description of 
symbolic parameters appears under “Symbolic 
Parameters." 


The name field of the 
ment may be blank, or 
symbolic parameter. 


prototype state- 
it may contain a 


The symbol in the operation fieid is the 
mnemonic operation code that must appear in 


all macro instructions that refer to this 
macro definition. The mnemonic operation 
code must not be the same as the mnemonic 


operation code of another macro definition 
in the source program or of a machine or 
assembler instruction as listed in Appendix 
G. 


The operand field may contain 0 to 200 
symbolic parameters separated by commas. 
If there are no symbolic parameters, com- 
ments may not appear. 
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assempler language statements would be gen- 
erated: 


cater Te Te Tee a EE ee 1 
|Name [Operation |Operand | 
Seti $---------~-4}---------.----------+---] 
[HERE |S17 {2,SAVE | 
| iL | 2, FIFLDS | 
| {ST {2, PIFLOA | 
| |L |2, SAVE | 
Weeden 5 ee ae ee ese ere Be eg 4 


below illustrates another 
MOVE macro instruction using 


The example 
use of the 


operands different from those in the 
preceding example. 
fos ev or Len pee he Gr ee ee 1 
| Name [Operation |Operand | 
swish wee Pe See $------------] 
Macro {LABEL [MOVE JIN, OUT | 
eeoecee bes see eo Slk {---------~--J 
Generated|LABEL [ST |2, SAVE | 
Generated | |L {2, OUT | 
Generated| [st |2, IN | 
Generated| [L |2,SAVE | 
baie s Bate Sa Uso see teS J 


If a symbolic parameter appears in the 
comments field of a model statement, it is 
not replaced by the corresponding charac- 
ters of the macro instruction. 





Parameters 





If a symbolic parameter in a ewodel 
statement is immediately preceded or fol- 
lowed by other characters or another sym- 
bolic parameter, the characters that cor- 
respond toe the symbolic parameter are com- 
bined in the generated statement with the 
other characters or the characters that 
correspond to the other symbolic parameter. 
This process is called concatenation. 


The macro definition, macro instruction, 


and generated statements in the following 
example illustrate these rules. 
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 resasa! Te Gos a hk ae ee a 1 
|Name |Operation|Operand | 


Header | 


Prototype | &NAME | MOVE | éTY, &P, &TO, &FROM 


| 
Model | 6NAME|[STETY |2,SAVEAREA | 
Model | | LETY |2, &P&FROM | 
Model | {ST&TY {2,6PéTO | 
Model | |LéTy {2, SAVEAREA | 
Treiler | | MEND | | 
}-----}--------- fo--------------- 1 
Macro JHERF | MOVE ]D, FIELL,A,5 | 
}---~- $--------- 4---------------- { 
Generated|HERE | STD j2, SAVEARRA | 
Generated | | LD [2, FIELDB 
Generated | | STD {\2,FIFLDA 
Generatea| [LD |2, SAVEAREA | 
Wee oo bola eae! MSs wire ht Sah EEE EE J 


The symbolic parameter 6éTY is used in 
each of the four model statements to vary 
the mnemonic operation code of each of the 
generated statements. The character D in 
the macro instruction corresponds to sym- 
bolic parameter &TY. Since &TY is preceded 
by other characters (i.e., ST and L) in the 
model stetements, the character that cor- 
responds to 6&TY (i.e., DBD) is concatenated 


with the other characters to form the 
operation fields of the generated state- 
ments. 


The symbolic parameters 6&P, &T0O, and 
&FROM are used in two of the model state- 
ments to vary part of the operand fields of 
the corresponding generated statements. 


The characters FIELD, A, and B correspond 
to the symbolic parameters 6P, 6TO, and 
&FROM, respectively. Since 6P is followed 


by &FROM in the second model statement, the 
charecters that correspond to them (i.e., 
FIELD and B) are concatenated to form part 
of the operand field of the second generat- 
ed statement. Similarly, FIELD and A are 
concatenated to form part of the operand 
field of the third generated statement. 


If the programmer wishes to concatenate 
a symbolic parameter with a letter, digit, 
left parenthesis, or period following the 
symbolic parameter he must immediately fol- 
low the symbolic parameter with a period. 
A period is optional if the symbolic param- 
eter is to be concatenated with another 


symbolic parameter, or a special character 
other than a left parenthesis or another 
period that follows it. 


If a symbolic parameter is immediately 
followed by a period, then the symbolic 
parameter and the period are replaced by 
the characters that correspond to the sym- 
bolic paremeter. A period that imnediately 


follows a symbolic parameter does not 
appear in the generated statement. 

The following macro definition, macrc- 
instruction, and generated statements 
illustrate these rules. 

 Saebarrag Toon et eee 1 
|Name [Operation|Operand | 
}-----4-~------- f-------------=- : 
Header | | MACRO | | 
Prototype | &NAME|MOVE [6P,6S,6R1,6R2 | 
Model [| SNAME|ST |)6R1,6S. (&R2) | 
Model | [L {ER1,6P.B | 
Model | {ST {éR1,EP.A | 
Model | |i {&R1,6S. (&R2) | 
Trailer | | MEND | | 
sooo esse. 4--------------- 
Macro [HERE |MOVE |FIELD,SAVE,2,4 | 
}----- }--------- f--------—--~--- 
Generated |HERE |ST |2,SAVE(4) | 
Generated | {L |2,FIELDB | 
Generated | [ST |2,FIELDA | 
Generated | [L ]2,SAVE(4) | 
boo Wee ea pe gee ce eee eee J 


The symbolic parameter &P is used in the 


second and third model statements to vary 
part of the operand field of each of the 
corresponding generated statements. The 


the macro instruction 
Since &P is to be 


characters FIELD of 
correspond to 6P. 


concatenated with a letter (i.e., B and A) 
in each of the statements, a period immedi- 
ately follows &P in each of the model 


statements. The period does not appear in 
the generated statements. 


Similarly, symbolic parameter 6S is used 
in the first and fourth model statements to 
vary the operand fields of the correspond- 
ing generated statements. 6S is followed 


by a period in each of the model state- 
ments, because it is to be concatenated 
with a left parenthesis. The period does 


not appear in the generated statements. 
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Comments Statements 





A model 
statement. A 


Statement may be a comments’ 
comments Statement consists 
of an asterisk in the begin column, fol- 
lowed by comments. The comments statement 
is used by the assembler to generate an 
assembler language comments statement, Just 
as other model statements are used by the 
assembler to generate assembler language 
statements. No variable symbol substitu- 
tion is performed. ; 


The programmer may also write comments 
statements in a macro-definition which are 
not to be generated. These statements must 
have a period in the begin column, . immedi- 
ately followed by an asterisk and the 
comments. 


The first statement in 
example wiil be 
generate a comments statement; 
statement will not. 


the following 
used by the assembler to 
the second 


| Name [Operation |Operand | 
}--------~-------~--------------~---------- { 
|* THIS STATEMENT WILL BE GENERATED | 
|.* THIS ONE WILL NOT BE GENERATED | 
tees e eee oe ee a ee 4 


NOTE: To get a truly representative sampl- 
ing of the various language components used 
effectively in writing macro instructions 
the programmer may list all or selected 


macro instructions from the SYS1.GENLIB or 
the SYS1.MACLIB by using the IEBPTPCH sys- 


tem utility covered in the S/360 Operating 
System, Utilities manual, C28-6586. 


COPY STATEMENTS 


COPY statements may be used to copy 
model statements and MEXIT, MNOTE, and 
conditional assemply instructions into a 
macro-definition, just as they may be used 
eutside macro definitions to copy source 
statements into an assembler language pro- 
gram. 
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The format of this statement is: 


fsa Testa Tow s pecans ee oe 1 
| Name {Cperation |Operand | 
 eiahtans anes eres | pa aes ae { 
[Blank |COPY |A symbol | 
[ee Me a ee He eS es 4 


The operand is a symbol that identifies 
a partitioned data set member to be copied 
from either the system macro library or a 
user library concatenated to it. The sym- 
bol must not be the same as the operation 
mnemonic cf a definition in the macro 
library. Any statement that may be used 
in a macre definition may be part of the 
copied coding, except MACRO, MEND, COPY, 
and prototype statements. 
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When considering statement positions 
within a program the code included by a 
COPY instruction statement should be con- 
sidered rather than the COPY itself. For 


example if a COPY statement in a macro- 
definition brings in global and local 
definition statements, it may appear 


immediately after the prototype statement. 
However, Since global definition statements 
must come before local definition state- 
ments, if glopal and local definition 
Statements are also specified explicitly in 
the macro definition which contains the 
COPY, the COPY must occur between the 
explicit globai definition statements and 
the explicit local definition statements. 


If §&Pi is a symbolic parameter ina 
prototype statement, and the corresponding 
operand of a macro-instruction is a sub- 
list, then 6Pi(n) may be used in a model 
Statement to refer to the nth operand of 
the sublist, where n may have a value 
greater than or equal to 1. N may be 
Specified as a decimal integer or any 
arithmetic expression allowed in a SETA 
instruction. (The SETA instruction is des- 
cribed in Section 9.) If the nth operand 
is omitted, then &Pi(n) would refer toa 
null character value. 


If the sublist notation is used but the 
operand is not a sublist, then 6F1(1) 
refers to the operand and éP1 (2), 
6F1(3),... vefer to a null character value. 
If an operand has the forn (), it is 
treated as a character string and not as a 
sublist. 


For example, consider the following 
macro-definition, macro-instruction, and 
generated statements. 
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[Name |Operation|Operand | 
}------ t--~------ $--------------- { 
Header | | MACRO | 
Prototype| | ADD | §NUM, &REG, &AREA| 
Model | [L | 6REG, &NUM(1) i 
Model | {A | SREG, ENUM(2) | 
Model | {A | REG, 6NUM(3) | 
Model | | ST | GREG, SAREA | 
Trailer | | MEND { { 
poreennnpanno mena fe-nana—n a= : 
Macro | j ADD | (A,B,C),6,SUM | 
Generated | |L ]6,A | 
Generated | {A {6,8 | 
Generated | {A [6,C | 
Generated | [Sst |¢,SUM | 
Pe Pose aS Enea eee ape J 


The operand of tne macro instruction 
that corresponds to symbolic parameter &NUM 
is a sublist. One of the operands in the 
sublist is referred to in the operand field 
of three of the model statements. For 
example, §NUM(1) refers to the first oper- 
and in the sublist corresponding to symbol- 
ic parameter 6NUM. The first operand of 
the sublist is A. Therefore, A replaces 


&NUM(1) to form part of the generated 
statement. 
Note: When referring to an operand ina 


sublist, the left parenthesis of the sub- 


list notation must immediately follow the 
last character of the symbolic parameter, 
e.g., &NUM(1). A period should not ke 


placed between the left parenthesis and the 
last character of the symbolic parameter. 


A period may be used between these two 
characters only when the programmer wants 
to concatenate the left parenthesis with 
the characters that the symbolic parameter 
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represents. The following example shows 
what would be generated if a period 
appeared between the left parenthesis and 
the last character of the symbolic parame- 
ter in the first model statement of the 
above example. 


fog = ie ae Rp ae 1 
[Name|Operation|Operand | 
}----$------~—- 4----------------- 4 
Prototype | | ADD [| &NUM,&REG,&AREA | 
Model | |L | REG, ENUM, (1) | 


p----4--------- }------~=---=----- 4 
Macro | | (A,B,C) ,6,SUM | 


The symbolic parameter ENUM is used in 
the operand field of the model statement. 


The characters (A,B,C) of the macro- 
instruction correspond to &NUM. Since &NUM 
is immediately followed py a period, 6&NUM 


and the period are replaced by (A,B,C). 
The period does not appear in the generated 
statement. The resulting generated 
statement is an invalid assembler language 
statement. 


INNER MACRO INSTRUCTIONS 


A Macro-instruction may be used as a 
model statement in a macro definition. 
Macro instructions used as model statements 
are called inner macro instructions. 


A macro instruction that is not used as 
a model statement is referred to as an 
outer macro instruction. 


The rule for inner macro instruction 
parameters is the same as that for outer 
macro instructions. Any symbolic param- 
eters used in an inner macro instruction 
are replaced by the corresponding characters 
of the outer macro instruction. An operand 
of an outer macro instruction sublist cannot 
be passed as a sublist to an inner macro 
instruction. 


The macro definition corresponding to an 
inner macro instruction is used to generate 


the statements that replace the inner 
macro instruction. 
The ADD macro instruction of the pre- 


vious example is used as an inner macrc 
instruction in the following example. 


The inner macro inStruction contains twce 


symbolic parameters, éS and 6&T. The 
characters (X,Y,2) and J of the macro 
instruction correspond to 6S and &T, 
respectively. Therefore, these characters 
replace the symbolic parameters in the 
operand field of the inner macro 
instruction. 
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The assembler then uses the macro 
definition that corresponds to the inner 
macro instruction to generate statements to 
replace the inner macro instruction. The 
fourth through seventh generated statements 


have been generated for the inner macro 
instruction. 
aaa a aE Teor ete en ag 1 
| Name |Operation| Operand | 
p----4---------~ foma anne ne 4 
Header i | MACRO | | 
Prototype] | COMP }§R1,6R2,6S,6T, &U | 
Model | [SR [&R1,6R2 | 
Model | {c J éR1,6T | 
Model | [BNE | 6U | 
Inner l | ADD {| 6S,i2,6T | 
Model |sU JA [| &R1,éT | 
Trailer | | MEND | | 
}----4--------- 4---~------------- 
Macro |K | COMP |10,11, (%,¥,2),5,K| 
ponanpen----=-- ame oe ce { 
Generated| {SR {10,11 | 
Generated| jc {10,0 | 
Generated | | BNE |K | 
Generated | {L [212,X% | 
Generated | JA {12,¥ | 
Generated| JA {12,2 | 
Generated | {ST [12,0 | 
Generated] [A {10,0 | 
Labo ence WSs See ees J 
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Further relevant limitations and differen- 
ces between inner and outer macro instruct- 
ions will be covered under the pertinent 
sections on sequence symbols, attributes, 
etc. 


Note: An ampersand that is part of a 
symbolic parameter is not considered in 
determining whether a macro instruction 


operand contains an even number of consecu- 
tive anpersands. 


LEVELS OF MACRO INSTRUCTIONS 


A macro definition that corresponds to 
an outer macro instruction may contain any 
number of inner macro instructions. The 
outer macro instruction is called a first 
level macro instruction. Each of the inner 
macro instructions is called a second level 
macro instruction. 


The macro definition that corresponds to 


a second level macro instruction may con- 
tain any number of inner macro 
instructions. These macro instructions are 


called third level macro instructions, etc. 


The number of levels of macro 
instructions that niay be used depends upon 
the complexity of the macro definition and 
the amount of storage available. 


HOW TO WRITE CONDITIONAL ASSEMBLY INSTRUCTIONS 


SECTION 9: 
The conditional assembly instructions 
allow the programmer to: (1) define and 


assign values to SET symbols that can be 
used to vary parts of generated statements, 
and (2) vary the sequence of generated 
statements. Thus, the programmer can use 
these instructions to generate many 
different sequences of statements from the 
same macro-definiticn. 


There are 13 conditional assembly 
instructions, 10 of which are described in 
this section. The other three conditional 
assembly instructions -- GBLA, GBLB, and 


GBLC -- are described in Section 10. The 
instructions described in this section are: 
LCLA SETA AIF ANOP 
LCLB SETB AGO 
LCLC SETC ACTR P 

The primary use of the conditional 
assembly instructions is in ma cro- 
definitions. However, all of them may be 
used in an assembler ilanguage source 
program. 


Where the use of an instruction outside 
macro-definitions differs from its use 
within mecro-definitions, the difference is 
described in the subsequent text. 


The LCLA, LCLB, and LCLC instruetions 
may be used to define and assign initial 
values to SET symbols. 


and SETC instructions 
arithmetic, binary, 
respectively, to SET 


The SETA, SETB, 
may be used to assign 
and character values, 


symbois. The SETB instruction is described 
after the SETA and SFTC instructions, 
because the operand field of the SETB 


instruction is a combination of the operand 
fields of the SETA and SETC instructions. 


The AIF, AGO, and ANOP instructions may 
be used in conjunction with sequence sym- 
bols to vary the sequence in which state- 
ments are processed by the assembler. The 
programmer can test attributes assigned by 
the assembler to symbols or macro- 
instruction operands to determine which 
statements are to be processed. The ACTR 
instruction may be used to vary the maximum 
number of AIF and AGO branches. 


Examples illustrating the use of 
conditional assembly instruction are 
included throughout this section. A chart 


summarizing the elements that can be used 
in each instruction appears at the end of 
this section. 
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SET SYMBOLS 


SET symbols are one type of variable 
symbol. The symbolic parameters discussed 
in Section 7 are another type of variable 
symbol. SET symbols differ from symbolic 
parameters in three ways: (1) where they 
can be used in an assembler language source 
program, (2) how they are assigned values, 
and (3) whether or not the values assigned 
to them can be changed. 


Symbolic parameters can only be used in 
macro-definitions, whereas SET symbols can 
be used inside and outside macro- 
definitions. 

Symbolic parameters are assigned values 
when the programmer writes a macro- 
instruction, whereas SET symbols are 
assigned values when the programmer writes 


SETA, SETB, 
instructions. 


and SETC conditional assembly 


Zach symbolic parameter is assigned a 
Single value for one usSe of a macro- 
definition, whereas the values assigned to 
each SETA, SETB, and SETC symbol can change 
during one use of a macro-definition. 


Defining SET Symbols 


SET symbols must _ be 
programmer before they are used. When a 
SET symbol is defined it is assigned an 
initial value. SET symbols may be assigned 
new values by means of the SETA, SETB, and 
SETC instructions. A SET symbol is defined 
when it appears in the operand field of an 
LCLA, LCLB, or LCLC instruction. 


defined by the 


Using Variable Symbols 


The SETA, SETB, and SETC instructions 
may be used to change the values assigned 
to SLTA, SETS, and SETC symbols, 
respectively. When a SET symbol appears in 
the name, operation, or operand field of a 
model statement, the current value of the 
SET symbol (i.e., the last value assigned 
to it) replaces the SET symbol in the 
statement. 


For example, if 6A is a symbolic parame- 
ter, and the corresponding characters of 
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the macro-instruction are tne symboi HERE, 
then HERE replaces each occurrence of 6A in 
the macro-definition. However, if &A is a 
SET symbol, the value assigned to 6A can be 
changed, and a different value can replace 
each occurrence of 6A in the macro- 
definition. 


The same variapole symbcl iray not pe used 
as a symbolic parameter and as a SET symbol 
in the same macro-definition. 


The following illustrates this rule. 


apart PROTA STA PSS PS ASST a TRS ETS SS Seas 1 
| Name }Operation jOperand | 
------- }-----------}~~-----~~---------- == +] 
J&NAME | MOVE | ETO, &FROM | 
Po eet Puke ees Pose ot eo Heese elle J 
If the statement above is a prototype 
statement, then &NAMF, &TO, and &FROM inay 
not be used as SET symbols in the macro- 
definition. 


The same variable symbol may not be used 
as two different types of S&T symbols in 
the same macro-definition. Similarly, the 
same variable symbol may not be used as two 
different types of SET symbols outside 
macro-definitions. 


For example, if 6A is a SETA sympol ina 
macro-definition, it cannot be used as a 
SETC symbol in that definition. Similarly, 
if 6A is a SETA symbol outside macro- 
definitions, it cannot he used as a SETC 
symbol outside macro-definitions. 


The same variable symbol may be used in 
two or more macro-definitions and outside 
macro~definitions. If such is the case, 
tne variable symbol will se considered a 
different variable symbol each time it is 
used. 


For example, if 6A is a variable symbol 
(either SET symbol or symbolic parameter) 
in one macro-definition, it can be used as 
a variable symbol (either SET symbol or 
symbolic parameter) in another definition. 
Similarly, if 6A is a variable symbol (SET 
symbol or symbolic parameter) in a macro- 
definition, it can be used as a SET symbol 
outside macro-definitions. 


All variable symbols may be concatenated 
with other characters in the same way that 
symbolic parameters may be concatenated 
with other characters. Tne rules for 
concatenating symbolic parameters with 
other characters are in Section 7 under the 
subsection “Symbolic Parameters." 


Variable symbols in macro-instructions 
are replaced by the values assigned to 
them, immediately prior to the start of 
processing the definition. If a SET symbol 
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is used in the operand field of a 
instruction, 
SET symrol is 
notation, the 
sublist. 


macro- 
and the value assigned to the 
equivalent to the sublist 
operand is not considered a 


ATTRIBUTES 


The assembler assigns attributes to 
macro-instruction operands and to sympols 
in the program. These attributes may be 
referrsd to only in conditional assembly 
instructions or expressions. 


There are six kinds of attributes. They 
are: type, length, scaling, integer, 
count, and number. Each kind of attribute 


is discussed in the paragraphs that follow. 


If an outer macro-instruction operand is 
a symbol before substitution, then the 
attributes of the operand are the same as 
the corresponding attributes of the symnol. 
The symbol must appear in the name field of 
an assembler language statement or in the 
operand field of an EXTRN statement in the 
progran. The statement must be outside 
macro-definitions and must not contain any 
variable symbols. 


If an inner macro-instruction operand is 
a symbolic parameter, then the attributes 
of the operand are the same as the attri- 
butes of the corresponding outer macro 
instruction operand. A symbol appearing as 
an inner macro instruction operand is not 
assigned the same attributes as the same 


symbol appearing as an outer macro instruc- 
tion operand. 


If a macro-instruction 
sublist, the programmer may 
attributes of either 
Operand in the suplist. The type, length, 
scaling, and integer attributes of a 
sublist are the same as the corresponding 
attributes of the first operand in the 
sublist. 


All the attributes of macro-instruction 


operand is a 
refer to the 
the sublist or each 


operands may be referred to in conditional 
assembly instructions within macro- 
definitions. However, only the type, 


length, scaling, and integer attributes of 
symbols may be referred to in conditional 
assembly instructions outside macro- 
definitions. Symbols appearing in the name 
field of ogenerated statements are not 
assigned attributes. 


Fach attribute has a notation associated 


with it. The notations are: 
Attribute Notation 
Type p 

Length L' 

Scaling s' 

Integer ate 

Count K' 

Number N' 


Tne programmer may refer to an attribute 
in the following ways: 


1. In a statement that is outside macro 
definitions, he may write the notation 
for the attribute immediately followed 
by a symbol. (¢e.g., T'NAME refers to 
the type attribute of the symbol 
NAME. ) 

2. In a statement that is in a macro- 
detinition, he may write the notation 
for the attribute immediately followed 
by a symbolic parameter. (e.g., 
L'éNAME refers to the length attribute 
of the characters in the macro~ 
instruction that correspond to 
symbolic parameter &NAME; L'&NAME(2) 
refers to the length attribute cf the 
second operand in the sublist that 
corresponds to sywbolic parameter 
&NAME.) 


Type Attripute (T") 


attribute of a macro 
operand, or a symbol is a 


The type 
instruction 
letter. 


The following letters are used for 
symbols that name DC and DS statements and 
for outer macro instruction operands that 


are sympols that name DC or DS statements. 
A A-type address constant, 
implied length, aligned, (also in 


CXD statement) 


B Binary constant. 

c Character constant. 

D Long floating-point constant, 
implied length, aligned. 

E Short floating-point constant, 


implied iength, aligned. 
F Full-word fixed-point constant, 
implied length, aligned. 
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G Fixed-point constant, explicit 
length. 

H Half-word fixed-point constant, 
implied length, aligned. 

K Floating-point constant, 


explicit length. 
Extended floating-point constant, 
implied length, aligned 
Packed decimal constant. 
V-type address constant, implied 
length, aligned. 
A-, S~, Q-, V-, or Y-type address 
constant, explicit length. 
S S-type address constant, 
implied length, aligned. 
Vv V-type address constant, 
implied length, aligned. 
Hexadecimal constant. 
Y-type address constant, 
implied length, aligned. 
Z zoned decimal constant. 


LOmus] ti 


m3 


KOK 


Tne following letters are used for sym- 
bols (and outer macro instruction operands 
that are symbols) that name statements 
other than DC or DS statements, or that 
appear in the operand field of an EXTRN 
statement. 


Machine instruction 
Control section name 
Macro instruction 
EXTRN symbol 
ccW instruction 
WXTRN symbol 
The following letters are used for inner 


?ASHEGUH 


and outer macro instruction operands only. 
N Self-defining term 
co) Omitted operand 


The following letter is used for inner 


and outer macro instruction operands that 
cannot be assigned any of the above let- 
ters. This includes inner macro 
instruction operands that are symbols. 
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This letter is also assigned to symbols 
that name EQU and LTORG statements, to any 
symbols occurring more than once in the 
name field of source statements, and to all 
symbols naming statements with expressions 
as modifiers. 


U Undefined 


The attributes of A, B, C and D are 
undefined in the following example: 


peor TST ae SS SS Se 1 
| Name [Operation |Operand | 
ee ee a a ee a a ee Le ee 
i \pc {SFr (AA-BB) '75' i 
{B |Dc | (AA-BB)F'15' 1 
[c [De | &X'1' { 
{D Ree | FL(3-2)'1!' | 
en dee Se Loewe coe eS 4 


The programmer may refer to a type 
attribute in the operand field of a SETC 
instruction, or in character relations in 
the operand fields of SETB or AIF 
instructions. 


Length (L"), Scaling (S‘), and Integer (1I") 
Attributes 


The Length, scaling, and integer attri- 
butes of macro instruction operands, and 
symbols are numeric values. 


The length attribute of a symbol (or of 
a macro instruction operand that is a 
symbol) is as described in Part I of this 
publication. Reference to the length at- 
tribute of a variable symbol is illegal 
except for symbolic parameters in SETA, 
SETB and AIF statements. If the basic L' 
attribute is desired, it may be obtained 
as follows: 


&A SETC "2! 
&B SETC Ere 
MVC &A. (&B&A) ,X 
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After generation, this would result in 
MVC Z(L'Z),X 


Conditional assembly instructions must 
not refer to the length attributes of 
symbols or macro instruction operands whose 
type attributes are the letters M, N, O, T, 
W, or $, 


Scaling and integer attributes are pro- 


vided for symbols that name fixed-point, 
floating-point, and decimal fields. 


Fixed and Floating Point: The scaling 
attribute of a fixed-point or floating- 


point number is the value given by the 
scale modifier. The integer attribute is a 
function of the scale and length attributes 
of the number. 


Decimal: The scaling attribute of a 
decimal number is the number of decimal 
digits to the right of the decimal point. 
The integer attribute of a decimal number 
is the number of decimal digits to the left 
cf the assumed decimal point after the 
number is assembled. 





Scaling and integer attributes are 
available for symbols and macro instruction 
operands only if their type attributes are 
H,F, and G, (fixed point); D,E,L, and K 
(floating point); or P and Z (decimal). 


The programmer may refer to the length, 
scaling, and integer attributes in the 
operand field of a SETA instruction, or in 
arithmetic relations in the operand fields 
of SETB or AIF instructions. 


Count Attribute (K"') 





The programmer may refer to the count 
attribute of macro instruction operands 
only. 


The value of the count attribute is 
equal to the number of characters in the 
macro instruction operand. It includes 
all characters in the operand, but does 
not include the delimiting commas. The 
count attribute of an omitted operand is 
zero. These rules are illustrated by the 
following examples: 


Operand Count Attribute 
ALPHA 5 

(JUNE , JULY , AUGUST) 18 

2( 10,12) 8 

A(2) 4 

tattpt 6 

' ' 3 

wr 2 

If a macro instruction operand contains 


variable symbols, the characters that 
replace the variable symbois, rather than 
the variable symbols, are used to determine 
the count attribute. 


The programmer may refer to the count 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF instruc- 
tions that are part of a macro-definition. 


Number Attribute (N') 


The programmer may refer to the 
attribute of macro-instruction 
only. 


number 
operands 


The number attribute is a value equal to 
the number of operands in an operand sub- 
list. The number of operands in an operand 
sublist is equal to one plus the number of 
commas that indicate the end of an operand 
in the sublist. 
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The following examples illustrate this 

rule. 

(A,B,C,D,E) 5 operands 
(A,,C,D,E) 5 operands 
{A,B,C,D) 4 operands 
(,B,C,D,E) 5 operands 
(A,B,C,D,) 5 operands 
(A,B,C,D,,) 6 operands 


If the macro-instruction operand is not 
a sublist, the number attribute is one. If 
the macre instruction operand is omitted, 
the nunber attribute is zero. 


The programmer may refer to the number 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF instruc- 
tions that are part of a macro definition. 


Assigning Attributes to Symbols 


The integer attribute is computed from 
the length and scaling attributes. 


Fixed Point: The integer attribute of a 
fixed-point number is equal to eight times 
the length attribute of the number minus 
the scaling attribute minus one; i.e., 
T'=8*L'-S'-1. 


Bach of the following statements defines 
a fixed-point field. The length attribute 
of HALFCON is 2, the scaling attribute is 
6, and the integer attribute is 9. The 


length attribute of ONECON is 4, the scal- 
ing attribute is 8, and the integer attri- 
bute is 23. 

fia ee Tis etd oak iis oe ey ee 1 
| Name |Operation |Operand i 
p-~------~ | an $-----------------~- : 
|HALFCON |DC | HS6'-25.93' | 
JONECON [DC | FS8'100.3E-2' | 
(engi aera nea g Eeescestice ae ant pa gf Wipe a a tte tea ee J 
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Floating Point: The integer attribute of a 
Type D or £ floating-point number is equal 
to two times the difference between the 
length attribute of the number and one, 
minus the scaling attribute; i.e., I'=2* 
(L'-1)-s'. 


Because of its low order characteristic, 
the integer attribute of a Type L constant 
with a length greater than 8 bytes is two 
less than the value indicated in the formula 
above. The integer attribute of a Type L 
constant with a length of 8 bytes or less 
is the same as the value indicated in the 
Formula above. 


Each of the following  wtatements defines 
a floating-point field. The length attri- 
bute of SHORT is 4, the scaling attribute 
is 2, and the integer attribute is 4. The 
length attribute of LONG is 6, the scaling 
attribute is 5, and the intecer attribute 
is 9. 


ae ener ad i ae aaah crete a aera ESS SS 1 
| Name ]Operation |Operand | 


+ 
|SHORT [DC JES2'46.415! | 
LONG |bc |DS5'-3.729' | 


| 
eee eee yi eta Avec anel Ip eet oe ee aR ET EE 


Decimal: The integer attribute of a pecked 
decimal number is equal to two times the 
length attribute of the number minus the 
scaling attribute minus one; i.e., 
I'=2*L'-S'-1. The integer attribute of a 
zoned decimal numper is equal to the dif- 
ference cetween the length attribute and 
the scaling attribute; i.e., I'=L'-s' 





Each of the following statements defines 
a decimal fielc. The length attribute of 
FIRST is z, the scaling attribute is 2, and 
the integer attribute is 1. The length 
attribute of SECOND is 3, the scaling 
attribute is 0, and the integer attribute 
is 3. The length attribute of THIRD is 4, 
the scaling attrioute is 2, end the integer 
attribute is 2. The length attribute of 
FOURTH is 3, the scaling attribute is 2, 
and the integer attribute is 3. 


occ eee Toc or ee e Tetra) Roe os op ee 4 
| Name Operation Operand 
4 Pp 

eR A oe oe A ee ee Se q 
| FIRST {Dc }P'4+1.25! | 
{SECOND |pDCc }z'-543° | 
{THIRD [pc |Z'79.68° | 
JFOURTH {DC |P'79,.68° | 
beat dos SS St dies meni SS es ee a) 
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SEQUENCE SYMBOLS 


The name field of a statement may con- 
tain a sequence symbol. Sequence symbols 
provide the programmer with the ability to 
vary the sequence in which statements are 
processed py the assembler. 


A sequence symool is used in the operand 
field of an AIF or AGO statement to refer 
to the statement named by the sequence 
syrbol. 


A sequence symbol is considered to be 
local to a macro definition. 


A sequence symbol may be used in the 
name field of any statenient that does not 
contain a symbol or S&T symbol except a 
prototyre statement, a MACRO, LCLA, LCLB, 
LCLC, GBLA, GBLB, GBLC, ACTR, IcTh, ISEQ, 
or COPY instruction. 


symbol consists of a period 
one through seven letters 
the first of which must be a 


A sequence 
followed by 
and/or digits, 
letter. 


The following are valid sequence syn- 
bols: 
. READER -A23456 
- LOOP2 ~X4F2 
oN 254 

The following are invalid sequence sym- 
bols: 
CARDARLKA (first character is not 

a period) 

-246B (first character after 


period is not a letter) 
-AREA2456 (more than seven characters 
after period) 


-BCD%84 (contains a Special character 
other than initial period) 

-IN AREA (contains a special 
character, i.e., blank, 


cther than initial period) 


If a seguence symbol appears in the name 
fiela of a macro-instruction, and the cor- 
responding prototype statement contains a 
symbolic ,arameter in the name field, the 
sequence symbol does not replace the sym- 
bolic parameter wherever it is used in the 
macro-definition. 


The fcllowing example illustrates this 
rule. 
[Sor Ssse Te or Te RE set Pi Dee 1 
| Name |Cperation |Cperand | 
}------- }~---------- $------------------- { 
| | MACRO | | 
1 [|&NAME |MOVE | &TO, &FROM | 
2 |&NAPE {ST | 2, SAVEAREA { 
| jL |2,6FROM | 
| | St |2,&TO | 
| |L | 2, SAVEAREA { 
| | MEND | | 
[-------}---~~------ }------------------- { 
3 |-SYM  |MOVE | FIELDA, FIELDS | 
}------- }~---------- }------------------- : 
4 | {ST | 2, SAVEAREA | 
| |L | 2, FIELDB | 
| {ST |2,FIELDA | 
| {L | 2, SAVEAREA | 
bones ee ot Se Poee ae e J 
The symbolic parameter &NAME is used in 
the name 


field of the prototype statement 
(statement 1) and the first model statement 
(statement 2). In the macro-instruction 


(statement 3) a sequence symbol (.SYM) 
corresponds to the symbolic parameter 
SNAME. §NAME is not replaced by .SyYM, and, 
therefore, the generated Statement 


(statement 4) does not contain an entry in 
the name field. 


LCLA, LCLB, LCLC -~ DEFINE LOCAL SET SYMBOLS 


The format of these instructions is: 


peda Tyee ee Py ce Pe eT He pe 1 
[Operation |Operand | 


One or more variable 


| 

| | LCLB, or |symbols, that are | 
| | LCLC {to be used as SET | 
| | |Symbols, separated | 
| | |by commas | 
banseso= Ba eee oe Hee Se ee J 
The LCLA, LCLB, and LcLC instructions 
are used to define and assign initial 
values to SETA, SETB, and SETC symbols, 
respectively. The SETA, SETB, and SETC 


symbols are assigned the initial values of 
Oo, O, and null character value, respective- 
ly. 


The programmer should not define any SET 


symbol whose first four characters are 
6SYS. 
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All LCLA, LCLB, or LCLC instructions in 
a macro definition must appear immediately 
after the prototype statement and GBLA, 
GBLB or GBLC instructions. All LCLA, LCLB, 
or LCLC instructions outside macro 
definitions must appear after all macro 
definitions in the source program, after 
all GBLA, GBLB, and GBLC instructions 
outside macro definitions, before all 
conditional assembly instructions, and 
PUNCH and REPRO statements outside macro 
definitions, and before the first con- 
trol section of the program. 


SETA -~- SET ARTTHMETIC 


The SETA 
assign an arithmetic value to a 
bol. 


instruction may be used to 
SETA sym- 
The format of this instruction is: 


Ceara Te aye ee Mee tg Be pe a as 1 
[Operation {|Operand | 


{An arithmetic | 
| expression | 


The expression in the operand field is 
evaluated as a signed 32-bit arithmetic 
value which is assigned to the SETA symbol 
in the name field. The minimum and maximum 


allowable values of the expression are ~231 


and +231-1, respectively. 
The expression may consist of one term 
or an arithmetic combination of terms. The 


terms that may be used alone or in combina- 
tion with each other are self-defining 
terms, variable symbcls, and the length, 
scaling, integer, count, and number attri- 
butes. Self-defining terms are described 
in Part I of this publication. 


Note: A SETC variable symbol may appear in 
a SETA expression only if the value of the 
SETC variable is one to eight decimal 
digits. The decimal digits will be con- 
verted to a positive arithmetic value. 


The arithmetic operators that may be 
used to combine the terms of an expression 
are + (addition), - (subtraction), 
* (multiplication), and / (division). 


An expression may not contain two terms 
or two operators in succession, nor may it 
begin with an operator. 


The following are valid operand fields 
of SETA instructions: 
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SAREA+X' 2D" I'éN/25 
&BETA*10 &EXIT-S' GENTRY+1 
L' €HERE+32 29 


The following are invalid operand fields 
of SETA instructions: 


SAREAX'C! (two terms in succession) 
6FIELD+- (two operators in succession) 
-&DELTA* 2 (begins with an operator) 
#432 (begins with an operator; 

two operators in succession) 
NAME/15 (NAME is not a valid term) 





The procedure used to evaluate the 
arithmetic expression in the operand field 
cf a SETA instruction is the same as that 
used to evaluate arithmetic expressions in 
assembler language statements. The only 
difference between the two types of arith- 


metic expressions is the terms that are 
allowed in each expression. 
The following evaluation procedure is 
used: 
1. Eacn term is given its numerical 
value, 
2. The arithmetic operations are per- 
formed moving from left to right. 
However, multiplication and/or divi- 


sion are performed before addition and 
subtraction. 


result is the value 
SETA symbol in the 


3. The computed 
assigned to the 
name field. 


The arithmetic expression in the operand 
fieid of a SETA instruction may contain one 
or more sequences of arithmetically com- 
pined terms that are enclosed in parenthe- 
ses. A sequence of parenthesized terms may 
appear within another parenthesized 
sequence. Only five levels of parentheses 
are allowed and an expression may not 
consist of more than 16 terms. Parentheses 
required for sublist notation, substring 
notation, and subscript notation count 
toward this limit. 


The following are examples of SETA 
instruction operani fields that contain 
parenthesized sequences of terms. 


(L' 6 HERE+32)*29 


&AREA+X'2D'/(EEXIT-S' &ENTRY+1) 
6BETA*10* (I'EN/25/ (EEXIT-S* &SENTRY+1) ) 


82 


The parenthesized portion or portions of 
an arithmetic expression are evaluated 
before the rest of the terms in the expres- 


sion are evaluated. If a sequence of 
parenthesized terms appears within another 
parenthesized sequence, the innermost 


sequence is evaluated first. 


Using SETA Symbols 


The arithmetic value assigned to a SETA 
symbol is substituted for the SFTA symbol 
when it is used in an arithmetic expres- 
sion. If the SETA symbol is not used in an 
arithmetic expression, the arithmetic value 
is converted to an unsigned integer, with 
leading zeros removed. If the value is 
zero, it is converted to a single zero. 


The following example illustrates this 
rule: 
(Sasser s ToS Sse oe Toe SS ee eae 1 
| Name {Operation |Operand | 
ieee ns cata Ease aieiete erica t—- arn nn | 
| MACRO | | 
|&NAME |MOVE | &TO, &FROM l 
{ | LCLA [| 6A, 6B, &C,&D | 
1 (éAa {SETA [10 | 
2 |&B {SETA {12 | 
3 {éc |SETA | 6A-6B | 
4 |6D | SETA {| SAt+EC | 
| NAME |st | 2, SAVEAREA 
5 | [L | 2, &FROMEC | 
6 | {ST | 2, &TOED 
| |L | 2, SAVEAREA 
| | MEND | | 
}-------}~---------- }------------------- { 
{HERE  |MOVE | FIELDA, FIELDB | 
------- }-----------}-------------------] 
|HERE [ST | 2, SAVEAREA 
| {L | 2, FIELDB2 | 
| sv | 2, FIELDA8 | 
| |L | 2, SAVEAREA { 
Wie Ss eet es ie Bo se a Oe 4 


Statements 1 and 2 assign to the SETA 
symbols 6A and 6B the arithmetic values +10 
and +12, respectively. Therefore, state~ 
ment 3 assigns the SETA symbol 6&cC the 
arithmetic value -2. When 6C is used in 
Statement 5, the arithmetic value -2 is 
converted to the unsigned integer 2. When 
é6C is used in statement 4, however, the 
arithmetic value -2 is used. Therefore, 6D 
is assigned the arithmetic vaiue +8. When 


6D is used in statement 6, the arithmetic 
value +8 is converted to the unsigned 
integer 8. 

The following example shows how the 


value assigned to a SETA symbol may _ be 
changed in a macro definition. 


| Saateaiannetentenens Rantuatenteabententententetenteen 


4 
| 
! 
! 
I 
! 
! 
{ 
! 
' 
t 
| 
' 
| 
! 
| 
! 
! 
! 
t 

4 


| Name foperation | Operand | 
}-----~-4-~~-~------ t------------------- { 
| | MACRO l | 
{SNAME | MOVE | &TO, FROM | 
| | LCLA [6A | 
1 [6A [SETA [5 | 
[$NAME |ST | 2, SAVEAREA | 
2] |L | 2, §FROMEA i 
3 [6A | SETA [8 | 
4 | [ST [2,§TOEA | 
| jL | 2, SAVEAREA | 
| | MEND | | 
Sane yayoae f---~+---+-~4-~------------------ 
[HERE |MOVE | FIELDA, FLELDB | 
|HERE [ST | 2, SAVEAREA i 
| |L | 2, FIELDB5 | 
| [st | 2, FIELDA8 | 
| [i [2. SAVEAREA | 
boas DS ee a a ee J 
Statement 1 assigns the arithmetic value 
+5 to SETA symbol &A. In statement 2, 6A 


is converted to the unsigned integer 5. 
Statement 3 assigns the arithmetic value +8 
to 6A. In statement 4, therefore, &A is 
converted to the unsigned integer 8, 
instead of 5. 


A SETA symbol may be used with a symbol- 
ic parameter to refer to an operand in an 
operand sublist. If a SETA symbol is used 
for this purpose it must have been assigned 
a positive value. 


Any expression that may be used in the 
operand field of a SETA instruction may be 
used to refer to an operand in an operand 
sublist. 


Sublists are described in 
under “Operand Sublists." 


Section 8 


The following macro definition may be 
used to add the last operand in an operand 
sublist to the first operand in an operand 


sublist and store the result at the first 
operand. A sample macro-instruction and 
generated statements follow the macro 
definition. 
ge am Learn ary as Ve fot ee ee 1 
| Name Joperation |Operand | 
}------}—----~----- foawa—aae nanan 1 
| | MACRO | i 
1 | | ADDX | &NUMBER, SREG | 
| | LCLA | &LAST I 
2 |&LAST |SETA | N'ENUMEER | 
| {L | EREG, ENUMBFR(1) | 
3 | |A | GREG, ENUMBER(&LAST) | 
{ |ST | REG, ENUMBER (1) | 
| | MEND | | 
fo----= | oe SEES fawn nnn nnn nn { 
4 | | ADDX | (A,B,C,D,E),3 | 
p--~--- t----------- $--=---~=------------ { 
| |i [3,4 | 
| |A [3,5 | 
| {st |3,A | 
boo soak Paso Se 5 ce ro eat See OE J 


Section 9: 


éNUMBER is the first symbolic parameter 
in the operand field of the prototype 
statement (statement 1). The corresponding 
characters, (A,B,C,D,E), of the macro- 
instruction (statement 4) are a sublist. 
Statement 2 assigns to &LAST the arithmetic 
value +5, which is equal to the number of 
operands in the sublist. Therefore, in 
statement 3, S&NUMBER(&LAST) is replaced by 
the fifth operand of the sublist. 


SETC ~- SET CHARACTER 


The SETC instruction is used to assign a 
character value to a SETC symbol. The 
format of this instruction is: 


JA SETC | SETC 
|symbol | 


{One operand, of | 
|the form described | 
ene’ | 


The operand field may consist of the 
type attribute, a character expression, a 
substring notation, or a concatenation of 
substring notations and character 
expressions. A SETA symbol may appear in 
the operand of a SETC statement. The 
result is the character representation of 
the decimal value, unsigned, with leading 


zeros removed. If the value is zero, one 
decimal zero is used. 
Type Attribute 

The character value assigned to a SETC 
symbol may be a type attribute. If the 
type attribute is used, it must appear 
alone in the operand field. The following 
example assigns to the SETC symbol 6&TYPE 


the letter that is the type attribute of 
the macro instruction operand that corre- 
sponds to the symbolic parameter &ABC. 


Pee ee ee ne 1 
| Name joperation operand | 
------- to----------$--------- === 
|&TYPE |SETC | T'éABc | 
Lot eecu Mi ee Leno Sse leoSSe se Sees 4 


Character Expression 


A character expression consists of any 
combination of (up to 255) characters 
enclosed in apostrophes. 


The first eight characters in a charac~ 
ter value enclosed in apostrophes in the 
operand field are assigned to the SETC 
Symbol in the name field. The maximum size 
character value that can be assigned to a 
SETC symbol is eight characters. 


Evaluation of Character Expressions: The 
following statement assigns the character 


value AB%4 to,the SETC symbol &ALPHA: 
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f + 
| ALPHA Ene 
I a ay ae eal sar me at esa ee ae Swe ae oes a ll we J 


More than one character expression may 
be concatenated into a single character 
expression by placing a period between the 


terminating apostrophe of one character 
expression and the opening apostrophe of 
the next character expression. For exam- 


ple, either of the following statements may 


be used to assign the character value 
ABCDEF to the SETC symbol SBETA. 
SN as SS tl a aS ee = 
[Name jOperacion jeperaca | 
}------- +---------=- fiona n-ne 4 
|&BETA |SETC | "ABCDEF' | 
| SBETA aoe | "ABC*.'DEF* | 
Loses eo Bee ee ee a pe J 
Two apostrophes must be used to rep- 
resent an apostrophe that is part of a 


character expression. 


The following statement assigns the 
character value L'SYMBOL to the SETC symbol 
& LENGTH. 


| Name Toneracion [operand | 
meee oe ce 4 
peRENGTH ee ['Lt'syMBou" | 
ee Seis Sie Ae et ee ee 4 

Variable symbols may be concatenated 


with other characters in the operand field 
of a SETC instruction according to the 
general rules for concatenating symbolic 
parameters with other characters (see Sec- 
tion 7). 


If SALPHA has been assigned the charac- 
ter value ABhY, the following statement may 
be used to assign the character value 
ABZ4URST to the variable symbol &GAMMA. 


Gee te ie ge oF eg ma i Pee Ne Pe ee Cea) ym 1 
| Name [Operation jOperand | 
~------- $~-~--------}----~---------------4 
{&GAMMA |SETC iene: RST! | 
bone eS Wee o oss coasebicta sin Joe see oes 4 


Two ampersands must be used to represent 
an ampersand that is not part of a variable 
symbol. Both ampersands become part of the 
character value assigned to the SETC sym- 
bol. They are not replaced by a single 
ampersand. 
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The following statement assigns the 
character value HALF&& to the SETC symbol 
SAND. 

Etta © > 3S Ee, a GE fons Sys ag be Se ngs eee” Shen ee ee q 
| Name | Operation Topenana | 
—— foa--- === fo =f 
J &AND {SETC LSuRT ESS { 
be ce gee ee Ga a ee J 


Substring Notation 


The character value assigned to a SETC 
symbol may be a substring character value. 
Substring character values permit the pro- 
grammer to assign part of a character value 
to a SETC symbol. 


If the programmer wants to 
of a character value to a SETC symbol, he 
must indicate to the assembler in the 
operand field of a SETC instruction: (1) 
the character value itself, and (2) the 
part of the character value he wants to 
assign to the SETC symbol. The combination 
of (1) and (2) in the operand field of a 
SETC instruction is called a substring 
notation. The character value that is 
assigned to the SETC symbol in the name 
field is called a substring character 
value. 


assign part 


Substring notation consists of a charac- 
ter expression, immediately followed by two 
arithmetic expressions that are separated 
from each other by a comma and are enclosed 
in parentheses. The two arithmetic expres- 
sions may be any expression that is allowed 
in the operand field of a SETA instruction. 


The first expression indicates the first 
character in the character expression that 
is to be assigned to the SETC symbol in the 
name field. The second expression indi- 
cates the number of consecutive characters 
in the character expression (starting with 
the character indicated by the first 
expression) that are to be assigned to the 
SETC symbol. If a substring asks for more 
characters than are in the character string 


only the characters in the string will be 
assigned. 

The maximum size substring character 
value that can be assigned to a SETC symbol 
is eight characters. The maximum size 
character expression the substring charac- 


ter value can be chosen from is 255 charac- 
ters. If a value greater than 8 is speci- 
fied, the leftmost 8 characters will be 
used. 


The following are valid substring nota- 
tions: 


"€ALPHA' (2,5) 
‘AB%4 ' (SAREA+2,1) 
"G€ALPHA. RST® (6, &A) 
"ABC&GAMMA* (6A, 6AREAt 2) 


The following are invalid substring 
notations: 
"6BETA' (4,6) 


(blanks between character value 
and arithmetic expressions) 
"L''SYMBOL' (142-EXYZ) 
(only one arithmetic expression) 
"ABS 4 SALPHA'T (8 &FIELD*2) 
(arithmetic expressions 
not separated by a comma) 
"BETA'Y, 6 
(arithmetic expressions 
not enclosed in parentheses) 


Using SETC Symbols 





The character value assigned to a SETC 
symbol is substituted for the SETC symbol 
when it is used in the name, operation, or 
operand field of a statement. 


For example, consider the following 
macro-definition, macro instruction, and 
generated statements. 

ama Tae ae TSS TA eee q 

| Name [Operation {Operana | 

}--------- 4----------- 4----------------- { 

{ | MACRO | | 

| 6NAME | MOVE |} &TO,&FROM | 

| LCLC { SPREFIX | 
1 | &PREFIX | SETC | ‘FIELD’ | 
| NAME |ST | 2, SAVEAREA | 
2 | ({L |2,6PREFIXEFROM = | 
3] {St |2, &€PREFIX&TO | 
| {L | 2, SAVEAREA | 
| | MEND | | 

}--------- 4----------- }----------------- { 

| HERE | MOVE JA,B | 

}--------- }----------- }--~~------------- { 

| HERE jst |2, SAVEAREA 

| |L | 2, FIELDB | 

| [ST \2,FIELDA | 

| |L | 2, SAVEAREA | 

beefs or oc Wice Se Seer We Be a J 


Statement 1 assigns the character value 


FIFLD to the SETC symbol 6PREFIX. in 
statements 2 and 3, &PREFIX is replaced by 
FIELD. 


shows how the 
symbol may be 


The following example 
value assigned to a SETC 
changed in a macro definition. 
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Petras Ta SS ress > To ears ta 1 
| Name [Operation |[|Operand | 
}--------- 4$------——--- 4----------------- : 

| MACRO | | 
| 6NAME | MOVE | &TO, €6FROM | 
| | LCLC | 6PREFIX | 

1 |§PREFIX |SETC | 'FIELD' | 
| NAME |sT | 2,SAVEAREA | 

2 | |L |2,&6PREFIX&EFROM | 

3 |&PREFIX |SETC | "AREA" | 

4 | {ST |2,€PREFIX&TO | 
| |L |2,SAVEAREA | 
| | MEND | | 
}--------- $----------- 4----------------- 4 
| HERE | MOVE {A,B | 
-----~--- }~----~---~--}~----------------4 
| HERE [sv |2,SAVEAREA | 
| |L |2,FITELDB | 
| {ST |) 2,AREAA | 
| |L | 2,SAVEAREA l 
bo ete dose eee Capea oer re ee J 
Statement 1 assigns the character vaiue 


FIELD to the SETC symbol &PREFIX. There- 


fore, &PREFIX is replaced by FIELD in 
Statement 2. Statement 3 assigns the char- 
acter value AREA to &PREFIX. Therefore, 


€PREFIX is replaced by AREA, instead of 


FIELD, in statement 4. 
illustrates the 


The following example 


use of a substring notation as the operand 
field of a SETC instruction. 
tates ee, Te oe ee To ee 71 
|Name [Operation |Operand | 
}---------}----------- $----------------- | 
| | MACRO | | 
| 6NAME | MOVE | &TO, FROM | 
| | LCLC | SPREFIX | 
1 |&PREFIX |SETC {'éTo' (1,5) | 
| NAME: |st | 2, SAVEAREA | 
2] |L |2,6PREFIX&FROM | 
| {ST |2,&TO | 
| |L |2,SAVEAREA | 
| | MEND | | 
~-------- $--------~--}-----------------4 
| HERE | MOVE | FIELDA, B | 
}--~~-----}----------- $2---------------- 4 
| HERE |SsT | 2, SAVEAREA | 
|L |2,FIELDB | 
| [st {2,FIELDA | 
| |L | 2,SAVEAREA | 
eee ere oe Pee oe en he Se a J 


Statement 1 assigns the substring char- 
acter value FIELD (the first five charac- 
ters corresponding to symbolic parameter 
6TO) to the SETC symbol &PREFIX. There- 
fore, FIELD replaces &PREFIX in statement 
2. 


Concatentating Substring Notations and 


Character Expressions: Substring notations 
may be concatenated with character expres- 


sions in the operand field of a SETC 
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instruction. If a substring notation fol- 
lows a character expression, the two may be 
concatenated by placing a period between 
the terminating apostrophe of the character 
expression and the opening apostrophe of 
the substring notation. 


for example, if &ALPHA has been assigned 
the character value AB%4, and &BETA has 
been assigned the character value ABCDEF, 
then the following statement assigns &GAMMA 
the character value ABR4BCD. 


nr ‘§BETA' (2, an 


If a substring notation precedes a char- 
acter expression or another substring nota- 
tion, the two may be concatenated by writ- 
ing the opening apostrophe of the second 
item immediately after the closing paren- 
thesis of the substring notation. 


The programmer may optionally place a 
period between the closing parenthesis of a 


substring notation and the opening apos- 
trophe of the next item in the operand 
field. 


If 6ALPHA has been assigned the charac- 


ter value ABS4, and &ABC has been assigned 
the character value 5RS, either of the 
following statements may be used to assign 
&WORD the character value ABZYU5RS. 

Qo ea eee Bog oe Ta i ee Peal 


[Name | Operation |Operand | 


| WORD |SETC |*6ALPHA' (1,4) "6ABC! 
| €WORD [sec [ALPHA (1,4) "saBc'(1, 3) | 


If a SETC symbol is used in the operand 
field of a SETA instruction, the character 
value assigned to the SETC symbol must be 
one to eight decimal digits. 


If a SETA symbol is used in the operand 
field of a SETC statement, the arithmetic 
value is converted to an unsigned integer 
with leading zeros removed. If the value 


is zero, it is converted to a single zero. 
SETB -- SET BINARY 

The SETB instruction may be used to 
assign the binary value 0 or 1 to a_éeSETB 


symbol. The format of this instruction is: 


86 


CR ere ae 1 
| Name jOpecation operand | 
}-------- t--------- 4--~~------------------ 
|A SETB |SETB [A 0 or a 1 enclosed or| 
|symbol | [not enclosed in paren-| 
| | |theses, or a logical | 
| | Jexpression enclosed | 
| | Jin parentheses | 
lee ae dee So eee ed 


The operand field may contain a 0 or ail 
or a logical expression enclosed in paren- 
theses. A logical expression is evaluated 
to determine if it is true or false; the 
SETB symbol in the name field is then 
assigned the binary value 1 or 0 corres- 
ponding to true or false, respectively. 


consists of one 
combination of terms. 

used alone ocr in 
with each other are arithmetic 
relations, character relations, and SETB 
symbols. The logical operators used to 
combine the terms of an expression are AND, 
OR, and NOT. 


A logical expression 
term or a logical 
The terms that may be 
combination 


An expression may not contain two terms 
in succession. A logical expression may 
contain two operators in succession only if 
the first operator is either AND or OR and 
the second operator is NOT. A logical 
expression may begin with the operator NOT. 
It may not begin with the operators AND or 
OR. 


An arithmetic relation consists of two 
arithmetic expressions connected by a rela- 
tional operator. A character relation con- 
sists of two character values connected by 
a relational operator. The relational 
operators are EQ (equal), NE (not equal), 
LT (less than), GT (greater than), LE (less 
than or equal), and GE (greater than or 
equal). 


Any expression that may be used in the 
operand field of a SETA instruction, may be 
used as an arithmetic expression in the 
operand field of a SETB instruction. Any- 
thing that may be used in the operand field 
of a SETC instruction may be used as a 
character value in the operand field of a 
SETB instruction. This includes substring 
and type attribute notations. The maximum 
size of the character values that can be 
compared is 255 characters. If the two 
character values are of unequal size, then 
the smaller one will always compare less 
than the larger one. 


The relational and Ilcgical operators 
must oe immediately preceded and followed 
by at least one blank or other special 
character. Each relation may or may not be 
enclosed in parentheses. If a relation is 
not enclosed in parentheses, it must be 


separated from the logical operators by at 
least one blank or other special character. 


The following are valid operand fields 
of SETB instructions: 


1 

(SAREA+2 GT 29) 

("ABAG* EQ *&ALPHA') 

(T' SABC NE T'&XYZ) 

(T'&P12 EQ 'F') 

(&AREA+2 GT 29 OR &B) 

(NOT &B AND &AREA+X'2D' GT 29) 
(*&C'EQ'MB') 

(0) 


The following are invalid operand fields 
of SETB instructions: 


&B (not enclosed in parentheses) 


(T'€P12 EQ 'F* &B) 
(two terms in succession) 
(‘ABZ4" EQ ‘ALPHA' NOT &B) 
(the NOT operator must be 
preceded by AND or OR) 
(AND T'&P12 EQ *F') 
(expression begins with AND) 


Evaluation of Logical Expressions 


used to 
oper- 


The following procedure is 
evaluate a logical expression in the 
and field of a SETB instruction: 


1. Each term (i.e., arithmetic relation, 
character relation, or SETB symbol) is 
evaluated and given its logical value 
(true or false). 


2. The logical operations are performed 
moving from left to right. However, 
NOTs are performed before ANDs, and 
ANDs are performed before ORs. 


value 
in the 


result is the 
SETB symbol 


3. The computed 
assigned to the 
name field. 


The logical expression in the operand 
field of a SETB instruction may contain one 
or more sequences of logically combined 
terms that are enclosed in parentheses. A 
sequence of parenthesized terms may appear 
within another parenthesized sequence. 


SETB 
contain 


The following are examples of 
instruction operand fields that 
parenthesized sequences of terms. 
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(NOT (&B AND 6AREA+X"2D' GT 29)) 
(&B AND (T'&P12 EQ ‘F' OR &B)) 


The parenthesized portion or portions of 
a logical expression are evaluated before 
the rest of the terms in the expression are 
evaluated. If a sequence of parenthesized 
terms appears within another parenthesized 
sequence, the innermost sequence is evalu- 
ated first. Five levels of parentheses are 
permissible. 


Using SETB Symbols 


The logical value assigned to a SETB 
symbol is used for the SETB symbol appear- 
ing in the operand field of an AIF instruc- 
tion or another SETB instruction. 


If a SETB symbol is used in the operand 
field of a SETA instruction, or in arith- 
metic relations in the operand fields of 
AIF and SETB instructions, the binary 
values 1 (true) and 0 (false) are converted 
to the arithmetic values +1 and +0, respec- 
tively. 


If a SETB symbol is used in the operand 
field of a SETC instruction, in character 
relations in the operand fields of AIF and 
SETB instructions, or in any other state- 
ment, the binary values 1 (true) and 0 
(false), are converted to the character 
values i and 0, respectively. 


The following example illustrates these 
rules. It is assumed that L'&TO EQ 4 is 
true, and S'&TO EQ 0 is false. 


[os 5 TSS Sa Tog ope ee 1 

| Name [Operation |Operand | 

}-------}~-----------}----—---------—-—-} 

| | MACRO | 
|&NAME | MOVE | STO, FROM 

| | LCLA j6Al | 

| | LCLB {&B1,&B2 | 

| LCLC {§c1 | 

1 | €B1 | SETB | (L'&TO EQ 4) | 

2 [&B2 | SETB {(S'&TO EQ 0) | 

3 |6AL | SETA | 6B1 | 

4 [6c1 |SETC |*&B2° | 

| [st | 2, SAVEAREA | 

| |L | 2, SFROMEAL | 

| |ST | 2, &TO&C1 | 

| |L | 2, SAVEAREA | 

| | MEND | { 

}-~-----}-----------}-------------------} 

| HERE | MOVE | FIELDA, FIELDB | 

~------}-----------}-------------------] 

| HERE {stv | 2, SAVEAREA j 

| |i {2,FIELDB1 | 

| [st | 2, FIELDAO | 

| |L | 2, SAVEAREA | 

bobo Sebo ee Sos Se ee eed 
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Because the operand field of statement 1 
is true, 6B1l is assigned the binary value 
1. Therefore, the arithmetic value +1 is 
substituted for 6&B1 in statement 3. 
Because the operand field of statement 2 is 
false, &B2 is assigned the binary value 0. 
Therefore, the character value 0 is substi- 
tuted for €B2 in statement 4. 


AIF ~- CONDITIONAL BRANCH 


The AIF instruction is used to condi- 
tionally alter the sequence in which source 
program statements or macro-definition 
statements are processed by the assembler. 
The assembler assigns a maximum count of 
4096 AIF and AGO branches that may be 
executed in the source progran or in a 
macro-definition. When a macro-definition 
calls an inner macro-definition, the cur- 
rent value of the count is saved and a new 
count of 4096 is set up for the inner 
macro-definition. When processing in the 
inner definition is completed and a_ return 
is made to the higher definition, the saved 
count is restored. The format of this 
instruction is: 


FESS SoC TS pat Se era aa a sere tS 
| Name |Operation|Operand | 
}--~------4---------}------~-------------- { 
|A se- | AIF |A logical expression | 
| quence | Jenclosed in paren- | 
{symbol or| {theses, immediately | 
| blank | {followed by a | 
| | {sequence symbol | 
beoc sete Boe SS Be ed 


Any logical expression that may be used 
in the operand field of a SETB instruction 
may be used in the operand field of an AIF 
instruction. The sequence symbol in the 
operand field must immediately follow the 
closing parenthesis of the logical expres- 
sion. 


The logical expression in the operand 
field is evaluated to determine if it is 
true or false. If the expression is true, 
the statement named by the sequence symbol 
in the operand field is the next statement 
processed by the assembler. If the expres- 
sion is false, the next sequential state- 
ment is processed by the assembler. 


The statement 
symbol may precede 
instruction. 


named by the sequence 
or follow the AIF 


If an AIF instruction is ina macro- 
definition, then the sequence symbol in the 
operand field must appear in the name field 
of a statement in the definition. If an 
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AIF instruction appears outside macro- 
definitions, then the sequence symbol in 
the operand field must appear in the name 
field of a statement outside macro- 
definitions. 


The following are valid operand fields 
of AIF instructions: 


(SAREA+X'2D' GT 29) .READER 
(T'&P12 EQ 'F').THERE 
('&PIELD3' EQ'') .NO3 


The following are invalid operand fields 
of AIF instructions: 


(T'&ABC NE T'&XYZ) 
-X4F2 
(T'&ABC NE T'&XYZ) 


(no sequence symbol) 
(no logical expression) 
~X4F2 
(blanks between logical 
expression and se- 
quence symbol) 


The following macro-definition may be 
used to generate the statements needed to 
move a full-word fixed-point number from 
one storage area to another. The 
statements will be generated only if the 
type attribute of both storage areas is the 
letter F. 


sina: Nata sear ato Goce ee een a ee 1 
| Name Joperation|Operand | 
}-----4--------- f---------------------- | 
| | MACRO | | 
| &N | MOVE [&T,&F | 

1 | | AIF ,(T'éT NE T'SF).END | 

2 | |AIF [(T'éT NE 'F'). END | 

3 |6N |sT | 2, SAVEAREA | 
| |L [2,6F i 
| {St |2,6T | 
| [L |2, SAVEAREA | 

4 |.END | MEND | | 
bso adoce oS Hose leosese eso lees J 


The logical expression in the operand 
field of statement 1 has the value true if 
the type attributes of the two macro- 
instruction operands are not equal. If the 
type attributes are equal, the expression 
has the logical value false. 


Therefore, if the type attributes are 
not equal, statement 4 (the statement named 
by the sequence symbol .END) is the next 
statement processed by the assembler. If 
the type attributes are equal, statement 2 


(the next sequential statement) is 
processed. 
The logical expression in the operand 


field of statement 2 has the value true if 
the type attribute of the first macro- 
instruction operand is not the letter F. 
If the type attribute is the letter F, the 
expression has the logical value false. 


Therefore, if the type attribute is not 
the letter F, statement 4 (the statement 
named by the sequence symbol .END) is the 
next statement processed by the assembler. 
If the type attribute is the letter F, 
statement 3 (the next sequential statement) 
is processed. 


AGO -- UNCONDITIONAL BRANCH 


The AGO instruction is used to 
unconditionally alter the sequence in which 
source program or macro-definition state- 
ments are processed by the assembler. The 
assembler assigns a maximum count of 4096 
AIF and AGO branches that may be executed 


in the source program or in a macro- 
definition. When a macro-definition calls 
an inner macro-definition, the current 


value of the count is saved and a new count 
of 4096 is set up for the inner macro- 


definition. When processing in the inner 
definition is completed and a return is 
made to the higher definition, the saved 


count is restored. The format of this 


instruction is: 


[ore a oe Se ME ee ae, eal 
| Name | Operation|Operand | 
}----------4~--------}-------------------- { 
JA sequence] AGO |A sequence symbol | 
[symbol or | | | 
| blank | | | 
Loci lSee es dese siete dia a ns Pt et J 

The statement named by the sequence 


symbol in the operand field is the next 
statement processed by the assembler. 


The statement named by the sequence 
symbol may precede or follow the AGO 
instruction. 


If an AGO instruction is part of a 
macro-definition, then the sequence symbol 
in the operand field must appear in the 
name field of a statement that is in that 


definition. If an AGO instruction appears 
outside macro-definitions, then the 
sequence symbol in the operand field must 


appear in the name field of a statement 


outside macro-definitions. 


The following example illustrates the 


use of the AGO instruction. 
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apenas Te CSRS SS Ti ee ea ag ee ee 1 
[Name |Operation|Operand | 
j------ f-=------- | Mie ca ci : 
| [MACRO | | 
[$NAME |MOVE |&T, &F | 
1 | | AIF {(T'ET EQ 'F'). FIRST | 
2 | | AGO | -END | 
3 |.FIRST|AIF | (T'éT NE T'&F).END | 
[&NAME |ST | 2, SAVEAREA | 
| [L |2, &F | 
| {ST |2,6T | 
| {L | 2, SAVEAREA { 
4 |.END |MEND | { 
tina does s BS ot eS ee J 
Statement 1 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is the letter F, 


statement 3 is the next statement processed 
by the assembler. If the type attribute is 
not the letter F, statement 2 is the next 
statement processed by the assembler. 


Statement 2 is used to indicate to the 
assembler that the next statement to be 
processed iS statement 4 (the statement 
named by sequence symbol .END). 


ACTR -- CONDITIONAL ASSEMBLY LCOP COUNTER 


The ACTR instruction is used to assign a 
maximum count (different from the standard 
count of 4096) to the number of AGO and AIF 
branches executed within a macro-definition 
or within the source program. The format 
of this instruction is as follows: 


acacia aca Te ee a a 1 
{Name |Operation|Operand | 
~---~-------- foan---- ==} -=---------------4 
| Blank | ACTR |Any valid SETA | 
| | | expression | 
Loco cee ee x gue eee Le ae J 


This statement, which can only occur 
immediately after the global and local 
declarations, causes a counter to be set to 
the value in the operand field. The coun- 
ter is checked for zero or a negative 
value; if it is not zero or negative, it is 


decremented by one each time an AGO or AIF 
branch is executed. If the count is zero 


before decrementing, the assembler will 
take one of two actions: 

1. If processing is being performed 
inside a macro definition, the entire 
nest of macro definitions will be 
terminated and the next source state- 


ment will be processed. 


2. If the source program is being proc- 
essed, an END card will be generated. 
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An ACTR instruction in a macro- 
definition affects only that definition; it 
has no effect on the number of AIF and AGO 
branches that may be executed in macro- 
definitions called. 





ANOP -- ASSEMBLY NO OPERATION 
The ANOP instruction facilitates 
conditional and unconditional branching to 


statements named by variable 


symbols. 


symbols or 


The format of this instruction is: 


(eee Tee I ee eee 1 
| Name {Operation |Operand | 
}-------- +----------- }----------~-------—- : 
JA se- | ANOP | Blank | 
[quence | | 
[symbol | | | 
Losout SS WS ie ee es oe ee J 


If the programmer wants to use an AIF or 
AGO instruction to branch to another state- 
ment, he must place a sequence symbol in 
the name field of the statement to which he 
wants to branch. However, if the program- 
mer has already entered a symbol or varia- 
ble symbol in the name field of that 
statement, he cannot place a sequence sym- 
bol in the name field. Instead, the pro- 
grammer must place an ANOP instruction 
before the statement and then branch to the 
ANOP instruction. This has the same effect 
as branching to the statement immediately 
after the ANOP instruction. 

The following example illustrates the 
use of the ANOP instruction. 


(oo nr ere eae Tet ee eee oe ee : 
| Name [Operation |Operand | 
f--~----. f-------—=- }----=--~------------ { 
| | MACRO i i 
| $NAME |MOVE |6T,&F { 
| | LCLC | TYPE | 
1 | | AIF )(T'éT EQ 'F").FTYPE | 
2 |&TYPE |SETC j'E" | 
3 |[.FTYPE [ANOP | | 
4 | ENAME | STETYPE [2 ,SAVEAREA l 
| | LETYPE |2,8F | 
| |STETYPE [2,67 { 
| | LETYPE |2,SAVEAREA | 
| | MEND | | 
Peseta oc: Bile th ee Pee eee 4 


90 


Statement 1 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is not the letter F, 
statement 2 is the next statement processed 
by the assembler. If the type attribute is 


the letter F, statement 4 should be 
processed next. However, since there is a 
variable symbol (&NAME) in the name field 


of statement 4, the required sequence sym- 
bol (.FTYPE) cannot be placed in the name 
field. Therefore, an ANOP instruction 
(statement 3) must be placed before state- 
ment 4. 


Then, if the type attribute of the first 
operand is the letter F, the next statement 
processed by the assembler is the statement 
named by sequence symbol .FTYPE. The value 
of &TYPE retains its initial null character 
value because the SETC instruction is not 
processed. Since .FTYPE names an ANOP 
instruction, the next statement processed 
by the assembler is statement 4, the state- 
ment following the ANOP instruction. 


CONDITIONAL ASSEMBLY ELEMENTS 


The following chart summarizes the ele- 
ments that can be used in each conditional 
assembly instruction. Each row in this 
chart indicates which elements can be used 


in a single conditional assembly instruc- 
tion. Each column is used to indicate the 
conditional assembly instructions in which 


a particular element can be used. 


The intersection of a column and ae row 
indicates whether an element can be used in 
an instruction, and if so, in what fields 
of the instruction the element can be used. 
For example, the intersection of the first 
row and the first column of the chart 
indicates that symbolic parameters can be 
used in the operand field of SETA instruc- 
tions. 


Fo ee red ON ee Ee ee ae eR ge ee fe ge TE ee eee aM a er 
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How to Write Conditional Assembly Instructions 


Section 9: 


SECTION 10: 


The extended features of the macro lan-~ 
guage allow the programmer to: 


1. Terminate processing of a macro 
definition. 


2. Generate error messages. 

3. Define global SET symbols. 

4. Define subscripted SET syrbols. 

5. Use system variable symbols. 

6. Prepare keyword and mixed-mode macro 
definitions and write keyword and 


mixed-mode macro instructions. 


7. Use other System/360 macro 
definitions. 


MEXIT ~- MACRO DEFINITION EXIT 


The MEXIT instruction is used to indi- 
cate to the assembler that it should termi- 
nate processing of a macro-definition. The 
format of this instruction is: 


capac aa aa Te ae ee oy er 1 
|Operation |Operand | 


4 
{A sequence | 
{symbol or | 
I 
4 


The MEXIT instruction may only be used 
in a macro-definition. 

If the assembler processes an MEXIT 
instruction that is in a macro-definition 
corresponding to an outer macro- 
instruction, the next statement processed 
by the assembler is the next statement 


outside macro-definitions. 


If the assembler processes an 
instruction that is in a macro-definition 
corresponding to a second or third level 
macro-instruction, the next statement proc- 
essed by the assembler is the next state- 
ment after the second or third level macro- 
instruction instruction in the macro- 
definition, respectively. 


MEXIT 


MEXIT 
MEND 


should not be confused with MEND. 
indicates the end of a macro- 
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EXTENDED FEATURES OF THE MACRO LANGUAGE 


MEND must be the last 
macro-definition, 


contain one or more 


definition. 
statement of every 
including those that 
MEXIT instructions. 


The following example illustrates the 
use of the MEXIT instruction. 
epee tear Teo SS as Pepa ee ee q 
| Name [Operation |Operand | 
[-------}----------~ pono ---- === === 4 
| | MACRO | | 
|ENAME |MOVE |&T, &F { 
1 | | AIF [| (T'&T EQ 'F').OK | 
2 | |MEXIT | | 
3 1.0K | ANOP i i 
{ENAME |ST | 2, SAVEAREA | 
| |L |2,6F | 
| | ST {2,6T | 
| {L | 2, SAVEAREA | 
| | MEND | | 
Un eecee, eee era eeeae Doe Sa oe hoe he oi J 
Statement i is used to determine if the 
type attribute of the first macro- 


instruction operand is the letter F. If 
the type attribute is the letter F, the 
assembler processes the remainder of the 
macro-definition starting with statement 3. 
If the type attribute is not the letter F, 
the next statement processed by the 
assembler is statement 2. Statement 2 
indicates to the assembler that it is to 
terminate processing of the macro- 
definition. 


MNOTE -- REQUEST FOR ERROR MESSAGE 


The MNOTE instruction may be used to 
request the assembler to generate an error 


message. The format of this instruction 
is: 

ing eho aca Tots ee seams aaa co 4 
| Name | Operation| Operand | 
}----------}~-~~-----}~-------------------- : 
|A sequence |MNOTE [A severity code, | 
[symbol, | | followed by | 
|variable {| [a comma, followed | 
|Isymbol or | |by any combination | 
|blank | [of characters en- | 
l | [closed in apostro- | 
| | | phes | 
bass SecsesS deers La bese. we Se ee oe So J 
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The operand cf the MNOTE instruction may 


also be written using one of the following 
forms: 
pee ae eS eS oe ee ee ase eer 7 
| Operand | 
}-—~~~=-—-~~~-~--+~-----------~- = ---- { 
Jseverity-code, 'message' | 
| ,"'message’ | 
| 'message' | 
beet o ses eso ee ee ee es J 
The MNOTE instruction may only be used 
in a macro-definition. Variable symbols 


may be used to generate the MNOTE mnemonic 
operation code, the severity code, and the 
message. 


The severity code may be a decimal 
integer from 0 through 255 or an asterisk. 
If it is omitted, 1 is assumed. The 


severity code indicates the severity of the 
error, a higher severity code indicating a 
more serious error. 


When MNOTE * 
the operand field 
comment. 


occurs, the statement in 
will be printed as a 


Two apostrophes must be used to 
represent an apostrophe enclosed in apos- 
trophes in the operand field of an MNOTE 
instruction. One apostrophe will be listed 
for each pair of apostrophes in the operand 
field. If any variable symbols are used in 
the operand field of an MNOTE instruction, 
they will be replaced by the values 
assigned to them. Two ampersands must be 
used to represent an ampersand that is not 
part of a variable symbol in the operand 
field of an MNOTE statement. One ampersand 
will be listed for each pair of ampersands 
in the operand field. 


The following example illustrates the 
use of the MNOTE instruction. 


PHS sapere sassSe= PRosossle cena eS Seas 7 
jName |Operation|Operand | 
bran fpr npr 
| MACRO | | 
| €NAME | MOVE | &T, &F | 
| | MNOTE |*, MOVE MACRO GEN' | 
1 | | AIF [(T'éT NE T'SF).M1 { 
2 | | AIF | (T'ET NE 'F').M2 | 
3 | €NAME|ST |2,SAVEAREA | 
| |i 12,6F | 
| ST |2,6T | 

| {L | 2, SAVEAREA 
| | MEXIT | | 
4 |.M1 |{MNOTE {'TYPE NOT SAME‘ | 
| | MEXIT H | 
5 |.M2  |MNOTE |'TYPE NOT F* | 
| | MEND | | 
Desh eas eee a i a ae aay 
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Statement 1 is used to determine if the 
type attributes of both macro-instruction 
operands are thé same. If they are, state- 
ment 2 is the next statement processed by 
the assembler. If they are not, statement 
4 ais the next statement processed by the 
assembler. Statement 4 causes an error 
message indicating the type attributes are 
not the same to be printed in the source 
program listing. 


Statement 2 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is the letter F, 
statement 3 is the next statement processed 
by the assembler. If the attribute is not 
the letter F, statement 5 is the next 
statement processed by the assembler. 
Statement 5 causes an error message indi- 
cating the type attribute is not F to be 
printed in the source program listing. 


GLOBAL AND LOCAL VARIABLE SYMBOLS 


The 
bols: 


following are iocal variable sym- 


1. Symbolic parameters. 
2. Local SET symbois. 
3. System variable symbols. 


Global SET symbols are the 
variable symbols. 


only global 


The GBLA, GBLB, and GBLC instructions 
define global SET symbols, just as the 
LCLA, LCLB, and LCLC instructions define 
the SET symbols described in Section 9. 
Hereinafter, SET symbols defined by LCLA, 
LCLB, and LCLC instructions will be called 
local SET symbols. 


Global SET symbols communicate values 
between statements in one or more macro- 
definitions and statements outside macro- 
definitions. However, local SET symbols 
communicate values between statements in 
the same mMacro-definition, or between 
statements outside macro-definitions. 


If a local SET symbol is defined in two 
or more macro-definitions, or in a macro- 
definition and outside macro-definitions, 
the SET symbol is considered to be a 
different SET symbol in each case. 
However, a global SET symbol is the same 
SET symbol each place it is defined. 


A SET symbol must be defined as a global 
SET symbol in each macro-definition in 
which it is to be used as a global SET 
symbol. A SET symbol must be defined as a 


global SET symbol outside macro- 
definitions, if it is to be used asa 
global SET symbol outside macro- 
definitions. 

If the same SET symbol is defined as a 


global SET symbol in one or more places, 
and as a local SET symbol elsewhere, it is 
considered the same symbol wherever it is 
defined as a global SET symbol, anda 
different symbol wherever it is defined as 
a local SET symbol. 


Defining Local and Global SET Symbols 


Local. SET symbols are defined when they 
appear in the operand field of an LCIA, 
LCLB, or LCLc instruction. These 


instructions are discussed in Section 9 


under “Defining SET Symbols." 


Global SET symbols are defined when they 
appear in the operand field of a GBLA, 


GBLB, or GBLC instruction. The format of 
these instructions is: 
compas Me eT ae ee 1 


r 
Operation |Operand 
1S 
|Blank |[GBLA, [One or more variable | 
| |GBLB, or |symbols that are to be | 
| | GBLC fused as SET symbols, | 
| 


[separated by commas 
= Ae bean oe eee J 


The GBLA, GBLB, and GBLC instructions 
define global SETA, SETB, and SETC symbols, 
respectively, and assign the same initial 
values as the corresponding types of local 
SET symbols. However, a global SET symbol 
is assigned an initial value by only the 
first GBLA, GBLB, or GBLC instruction proc- 


essed in which the symbol appears. Subse- 
quent GBLA, GBLB, or GBLC instructions 
processed by the assembler do not affect 


the value assigned to the SET symbol. 


The programmer should not define any 
gichal SET symbols whose first four charac- 
ters are 6SYS. 


If a GBLA, GBLB, or GBLC instruction is 
part of a macro-definition, it must immedi- 
ately follow the prototype statement, or 
another GBLA, GBLB, or GBLC instruction. 
GBLA, GBLB, and GBLC instructions outside 
macro-definitions must appear after all 
macro-Gefinitions in the source program, 
before all conditional assembly instruc- 
tions and PUNCH and REPRO statements out- 
side macro-definitions, and before the 
first control section of the program. 


All GBLA, GBLB, and GBLC instructions in 


a macro-definition must appear before all 
LCLA, LCLB, and LCLC instructions in that 
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macro-definition. All GBLA, GBLB, and GBLC 
instructions outside macro-definitions must 
appear before all ILCLA, LCLB, and LCLC 
instructions outside macro-definitions. 


Using Global and Local SET Symbols 
The following examples illustrate the 


use of global and local SET symbols. Each 
example consists of two parts. The first 
part is an assembler language source pro- 


gram. The second part shows the statements 
that would be generated by the assembler 
after it processed the statements in the 
source program. 


Example 1: This example illustrates how 

the same SET symbol can be used to communi- 

cate (1) values between statements in the 

same macro-definitions, and (2) different 

values between statements outside macro- 
definitions. 

SS Toe en ed 

| Name {Operation |Operand | 

t-------+----------- fren nnn ncn 4 

| | MACRO | { 

{&NAME |LOADA | | 

1 | | LCLA | 6A | 

2 |&NAME |LR ]15,6A | 

3 |6A | SETA { 6A+1 | 

| | MEND | | 

| { | | 

4 {| | LCLA [SA | 

JFIRST |LOADA | | 

5 | | LR {15,6A | 

I | LOADA | | 

6 | | LR ]15,6A | 

| | END | FIRST | 

p~---=~~ fawn enn nnn fon nn nn nnn nnn nana : 

|FIRST {LR (15,0 | 

| | LR [15,0 | 

| LR 115,90 | 

| | LR {15,0 | 

| | END | FIRST | 

Loon fuk desu noo Were: eels mieten ae J 


6A is defined as a local SETA symbol in 
a macro definition (statement 1) and 
outside macro definitions (statement 4). 
6A is used twice within the macro 
definition (statements 2 and 3) and twice 
outside macre definitions (statements 5 and 
6). 


Since 6A is a local SETA symbol 
macro definition and outside macro 
definitions, it is one SETA symbol in the 
macro definition, and another SETA symbol 
outside macro definitions. Therefore, 
statement 3 (which is in the 
macro definition) does not affect the value 
used for 6A in statements 5 and 6 (which 
are outside macro definitions). Moreover, 
the use of LOADA between statements 5 and 6 
will alter &A from its previous value as a 
local symbol within that macro definition 
since the first act of the macro definition 
is to LCLA &A to zero. 


in the 
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Example 2: This example illustrates how a 
SET symbol can be used to communicate 


values between statements that are part of 

a macro-definition and statements outside 
macro-definitions. 

aap Seaham eerste Tot Rr ae 1 

{Name |Operation |Operand | 

}-------}-----~----- -~----------------- 1 

{ | MACRO | | 

|SNAME |LOADA | | 

1 | |GBLA | 6A | 

2 |&NAME [LR }15,&A | 

3 {&A | SETA | 6A+1 | 

| | MEND | | 

| { | l 

4 | |GBLA. | 6A | 

]FIRST |LOADA | | 

5 | [LR [15,8A | 

| {| LOADA | | 

6 | | LR {15,6A | 

1 [END | FIRST | 

}------- $-----------+----- -------------- { 

|FIRST |LR }15,¢ | 

| | LR J15,1 | 

| LR [15,1 | 

| [LR |15,2 | 

| | END | FIRST | 

Poo os oa f bpleabet eee ea ryt Pesta Sh aks J 


&A is defined as a global SETA symbol in 
a macro-definition (statement 1) and out- 
side macro-definitions (statement 4). éA 
is used twice within the macro-definition 
(statements 2 and 3) and twice outside 
macro-definiticns (statements 5 and 6). 


Since 6A is a global SETA symbol in tne 
macro-definition and outside macro- 
definitions, it is the same SFTA symbol in 
both cases. Therefore, statement 3 (which 
is in the macro-definition) affects the 
value used for 6A in statements 5 and 6 
(which are outside macro-definitions)., 


Example 3: This example illustrates how 
the same SET symbol can be used to 
communicate: (1) values between statements 


in one macro-definition, and (2) different 
values between statements in a different 
macro-definition. 


6A is defined as a local SETA symbol in 
two different macro-definitions (statements 


1 and 4). éAis used twice within each 
macro-~definition (statements 2, 3, 5, and 
6). 


Since 6A is a local SETA symbol in each 
macro-definition, it is one SETA symbol in 
one macro-definition, and another SETA sym- 
bol in the other macro-definition. There- 
fore, Statement 3 (which is in one 
macro-definition) does not affect the value 
used for &A in statement 5 (which is in the 
other macro-definition). Similarly, state- 
ment 6 does not affect the value used for 
&éK in statement 2. 
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fae Toe 
| Cperation 
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e 
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| LR }15,6A 
| 6A+1 


ROS 


FIRST 


Example 4: This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part of 
two different macro-definitions. 


7 
|Name {Operation |Operand | 
fe---- ft --r nnn : sSataeeneenenanataeteneieteanenaten 4 
| | MACRO | | 
| NAME | LOADA | | 

1 |GBLA J 6A | 

2 |&NAME {LR [15,6A | 

3 [6A | SETA | 6A+1 | 
| | MEND | | 
| | | | 
| | MACRO | | 
| | LOADB | | 

4u | |GBLA [6a | 

5 | | LR }15,6A | 

6 |6A | SETA | SA+1 | 
| | MEND | | 
| | | 
| FIRST | LOADA | | 
| | LOADB | | 
| | LOADA | | 
| | LOADB { | 
| | FEND {FIRST | 
t------- fear asss sea torre rrr 4 
[FIRST |LR {15,9 | 
| | LR {15,1 | 

| LR 15,2 | 
| [LR (15,3 | 
| {END | FIRST i 
(oes Loci cocoeeee Poo e gon oho ot 4 


&A is defined as a global SETA symbol in 
two different mecro-definitions (statements 
1 and 4). &A is used twice within each 
macro-definition (stetements 2, 3, 5 and 
6). 


Since 6A is a global SETA symbol in each 
macro-definition, it is the same SFTA syr- 
bol in each macro-definition. Therefore, 
statement 3 (which is in one 
macro-definition) affects the value used 
for 6A in statement §& (which is in the 
other macro-definition). Sinilarly, state- 
ment 6 affects the value usec for 6A in 
statement 2. 


Example 5: This example illustrates how 
the same SET symbol can be used to communi- 


cate: (1) values between statements in two 
different macro-definitions, and (2) dif- 
ferent values between statements outside 
macro-definitions. 
fy Teos oe oe oe. asa at a 1 
| Name [Operation |Operand | 
[-------4----------- tesasreac sree oasso | 
| | MACRO | | 
| 6NAME | LOADA | | 
1 | |GBLA [6A | 
2 | &NAME | LR |15,6A | 
3 [6A | SETA | 6Ati | 
| | MEND { | 
| | | 
| | MACRO | | 
| | LOADB | | 
4 | |GBLA [6A | 
5 | [LR [15,6A | 
6 |&A {SETA | 6A+1 | 
| | MEND | | 
| { | 
7 | [ LCLA [6A | 
|FIRST |LOADA | { 
\ | LOADB | | 
8 | | LR }15,6A | 
| | LOADA | | 
| | LOADB | | 
9 | | LR ]15,6A | 
{ | END | FIRST | 
pro--a---$--- =~ === fon nnn nnn { 
{FIRST |LR [15,0 | 
| [LR {15,1 | 
| [LR J15,0 | 
| | LR {15,2 | 
| | LR {15,3 | 
| | LR {15,0 | 
{ J END | FIRST | 
Coot. SS oe SS doe a eS J 


6A is defined as a global SETA symbol in 
two different macro-definitions (statements 
1 and 4), but it is defined as a local SETA 
symbol outside macro-definitions (statement 


7). éA is used twice within each macro- 
definition and twice outside macro- 
definitions (statements 2, 3, 5, 6, 8 and 
9). 
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Since 6A is a global SETA symbol in each 
macro-definition, it is the same SETA 
symbol in each macro-definition. However, 
since 6A is a local SETA symbol outside 
macro-~definitions, it is a different SETA 
symbol outside macro-definitions. 


Therefore, statement 3 (which is in one 
macro-definition) affects the value used 
for 6A in statement 5 (which is in the 
other macro-definition), but it does not 
affect the value used for &A in statements 
8 and 9 (which are outside 
macro-definitions). Similarly, statement 6 
affects the value used for &A in statement 
2, but it does not affect the value used 
for 6A in statements 8 and 9. 


Subscripted SET Symbols 


Both global and local SET symbols may be 
defined as subscripted SET symbols. The 
local SET symbols defined in Section 9 were 
all nonsubscripted SET symbols. 


Subscripted SET symbols provide the pro- 
grammer with a convenient way to use one 


SET symbol plus a subscript to refer to 
many arithmetic, binary, or character 
values. 


A subscripted SET symbol consists of a 
SET symbol immediately followed by a sub- 
script that is enclosed in parentheses. 
The subscript may be any arithmetic expres- 
sion that is allowed in the operand field 
of a SETA statement. The subscript may not 
be 0 or negative. 

The following are valid subscripted SET 
symbols. 


&READER (17) 
6A23456(ES4) 
&X4F2(25+6A2) 


The following 
SET symbols. 


are invalid subscripted 


&X4F2 (no subscript) 
(25) (no SET symbol) 
6X4F2 (25) (subscript does not 


immediately follow 
SET symbol) 


Defining Subscripted SET Symbols: If the 
programmer wants to use a subscripted SET 


symbol, he must write in a GBLA, GBLB, 
GBLC, LCLA, LCLB, or LCLC instruction, a 
SET symbol immediately followed by a deci- 
mal integer enclosed in parentheses. The 
decimal integer, called a dimension, indi- 
cates the number of SET variables associat- 
ed with the SET symbol. Every variable 
associated with a SET symbol is assigned an 
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initial value that is the same as the 
initial value assigned to the corresponding 
type of nonsubscripted SET symbol. 


If a subscripted SET symbol is defined 
as global, the same dimension must be used 
with the SET symbol each time it is defined 
as global. 


The maximum dimension that can be used 
with a SETA, SETB, or SETC symbol is 2500. 


A subscripted SET symbol may be used 
only if the declaration was subscripted; a 
nonsubscripted SET symbol may be used only 
if the declaration had no subscript. 


statements define the 
giobal SET symbols &SBOX, &WBOX, and &PSW, 
and the local SET symbol &TSW. &§SBOX has 
50 arithmetic variables associated with it, 
6WBOX has 20 character variables, &PSW and 
&TSW each have 230 binary variables. 


The following 


a a aE 1 
| Name joperacion jOperand | 
J---=--}----------- focn nena j 
| | GBLA | &SBOX (50) | 
| [| GBLC | €&WBOX (20) | 
{ | GBLB | &PSw(230) | 
| [| LCLB Tetentes0) | 
Lever PSS Be Soe A ee Oe J 


Using Subscripted SET Symbols: After the 
programmer has associated a number of SET 


variaples with a SET symbol, he may assign 
values to each of the variables and use 
them in other statements. 


If the statements in the previous exam- 
ple were part of a macro-definition, (and 
6A was defined as a SETA symbol in the same 
definition), the following statements could 
be part of the same macro-definition. 


PRS Se tee ee ee ee ee 1 
| Name operation loperana l 
f------~--- $-~----~--- t----------------- { 

1 |éA | SETA 15 | 

2 |SPSW(SA) |SETB {(6 LT 2) | 

3 | &TSW(9) | SETB { (€PSW(EA)) | 

4 | fA |2,=F'&SBOX(45)' | 

5 | | CLI | AREA, C'éEWBOX(17)'|{ 
a ce i st i a a a a i a ae as 

Statement 1 assigns the arithmetic value 

5 to the nonsubscripted SETA symbol 6A. 


Statements 2 and 3 then assign the binary 
value 0 to subscripted SETB symbols 6&PSW(5) 


and éTSW(9), respectively. Statements 4 
and 5 generate statements that add the 
value assigned to &SBOX(45) to general 


register 2, and compare the value assigned 
to &WBOX(17) to the value stored at AREA, 
respectively. 
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SYSTEM VARIABLE SYMBOLS 


System variable symbols are local vari- 
able symbols that are assigned values auto- 
Matically by the assembler. There are 


three system variable symbols: &SYSNDX, 
&SYSECT, and é&éSYSLIST. System variable 
symbols may be used in the name, operation 


and operand fields of statements in macro- 
definitions, but not in statements outside 
macro-definitions. They may not be defined 
as symbolic parameters or SET symbols, nor 
may they be assigned values by SETA, SETB, 
and SETC instructions. 


&ESYSNDX -- Macro Instruction Index 


The system variable symbol &SYSNDX may 
be concatenated with other characters to 
create unique names for statements 
generated from the same model statement. 


éSYSNDX is assigned the four-digit nur- 
ber 0001 for the first macro-instruction 
processed by the assembler, and it is 
incremented by one for each subsequent 
inner and outer macro instruction proc- 
essed. 


If &SYSNDX is used in a model statement, 
SETC or MNOTE instruction, or a character 
relation in a SETB or AIF instruction, the 
value substituted for &SYSNDX is the four- 
digit number of the macro-instruction being 
processed, including leading zeros. 


If &SYSNDX appears in arithmetic 
expressions (e.g., in the operand field of 
a SETA instruction), the value used for 
&SYSNDX is an arithmetic value. 


Throughout one use of a macro- 
definition, the value of &SYSNDX may be 
considered a constant, independent of any 
inner macro-instruction in that definition. 


The example in the next column 
illustrates these rules. It is assumed 
that the first macro-instruction processed, 
OUTER 1, is the 106th macro-instruction 
processed by the assembler. 


Statement 7 is the 106th macro- 
instruction processed. Therefore, &SYSNDX 
is assigned the number 0106 for that macro- 
instruction. The number 0106 is 
substituted for &SYSNDX when it is used in 
statements 4 and 6. Statement 4 is used to 
assign the character value 0106 to the SETC 
symbol &NDXNUM. Statement 6 is used to 
create the unique name B0106. 


aa aera Too tS Te SSeS 1 

| Name |Operation |Operand | 

po--n a anna f onan a == TE : 

| | MACRO | | 

| | INNER1 | | 

| {GBLC | &(NDXNUM | 

1 |A&SYSNDX |SR {2,5 | 
| [CR }2,5 | 

2 | | BE | BENDXNUM | 
3 | [|B | ASSYSNDX | 
| | MEND | | 

{ | | | 

| | MACRO | | 

| 6NAME | OUTER1 | | 

l | GBLC | &NDXNUM | 

4 | &NDXNUM | SETC |" &SYSNDx" | 
| SNAME | SR }2,4 | 

| | AR |2,6 | 

5 | | INNER1L | | 
6 |B&SYSNDX |S |2,=F°1000° | 
| | MEND | | 
SSCaRsiaiainiah poeta fonnnn anna anne 

7 [ALPHA | OUTER1 | | 
8 {BETA [| OUTER1 | | 
poo-am === forannannee- fovnnnneeennnnesn 4 

| ALPHA |SR [2,4 | 

i {AR [2,6 | 

| A0107 | SR |2,5 | 

| {CR [2,5 | 

| | BE {B0106 | 

| [B }A0107 | 
[50106 {s {2,=F'1000' | 

| BETA |SR {2,4 | 

| |AR 12,6 | 
{A0109 {SR |2,5 | 

| [CR (2,5 | 

| | BE [30108 | 
|B {A0109 | 

|B0108 |S |2,=F'1000' | 
capes ope Locate eels Be ae ee ee d 
Statement 5 is the 107th macro~ 
instruction processed. Therefore, &SYSNDX 


is assigned the number 0107 for that macro- 


instruction. The number 0107 is 
substituted for &SYSNDX when it is used in 
statements 1 and 3. The number 0106 is 
substituted for the global SETC symbol 
ENDXNUM in statement 2. 

Statement 8 is the 108th macro- 
instruction processed. Therefore, each 


eccurrence of &SYSNDX is replaced by the 
number 0108. For example, statement 6 is 
used to create the unique name BO0108. 


When 


statement 5 is used to process tne 
108th } 


Macro-instruction, statement 5 
becomes the 109th macro-instruction proc- 
essed. Therefore, each occurrence of 
&SYSNDX is replaced by the number 0109. 
For example, statement 1 is used to create 
the unique name A0109. 
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&SYSECT -- Current Control Section 


The system variable symbol &SYSECT may 


be used to represent the name of the 
control section in which a macro- 
instruction appears. For each inner and 


outer macro-instruction processed by the 
assembler, &SYSECT is assigned a value that 
is the name of the control section in which 
the macro-instruction appears. 


When &SYSECT is used in a macro- 
definition, the value substituted for 
&6SYSECT is the name of the last CSECT, 
DSECT, or START statement that occurs 
before the macro-instruction. If no named 
CSECT, DSECT, or START statements occur 


before a macro-instruction, é&SYSECT is 
assigned a null character value for that 
macro-instruction. 


CSECT or DSECT statements processed ina 


macro-definition affect the value for 
&6SYSECT for any subsequent inner macro- 
instructions in that definition, and for 
any other outer and inner macro- 
instructions. 

Throughout the use of a macro-~ 
definition, the value of &SYSECT may be 
considered a constant, independent of any 
CSECT or DSECT statements or inner macro- 
instructions in that definition. 

The next example illustrates these 
rules. 


Statement 8 is the last CSECT, DSECT, or 
START statement processed before statement 
9 is processed. Therefore, 6&SYSECT is 
assigned the value MAINPROG for macro- 
instruction OUTER1 in statement 9. 
MAINPROG is substituted for &SYSECT when it 
appears in statement 6. 


Statement 3 is the last CSECT, DSECT, or 


START statement processed before statement 
4 is processed. Therefore, 6&SYSECT is 
assigned the value cCSOUT1 for macro- 


instruction INNER in statement 4. CSOUT1 
is substituted for &6SYSECT when it appears 
in statement 2. 


Statement 1 is used to generate a CSECT 
statement for statement 4. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 5. Therefore, 
6SYSECT is assigned the vaiue INA for 
Macro-instruction INNER in statement 5. 
INA is substituted for 6&SYSECT when it 
appears in statement 2. 
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fay Ta ac ae TS SS 1 
| Name {Operation |Operand | 
[---------- fe---------- }--------------- { 
| | MACRO | | 
| |] INNER | SINCSECT { 

1 |[&INCSECT |CSECT | 
2 | ppc | ACESYSECT) | 
| | MEND | | 
| | | i 
| | MACRO i | 
{ | OUTER1 | | 
3 |csouTt |CSECT | | 
| | DS {100C I 
| | INNER | INA 
5 | | INNER | INB | 
6 | jpc | AC &SYSECT) | 
| MEND | ] 
| | | I 
| | MACRO | j 
| J OUTER2 | | 
7 | | Dc | AC&SYSECT) | 
{ | MEND | | 
}---~-~----+----------- }-~-----~------- : 
8 |MAINPROG |CSECT | | 
| Jps [200c | 
9 | {OUTER1 | { 

10 | JOUTER2 | | 
~~-~ ~~ --- f= +-----+-- }---------------| 
|MAINPROG |CSECT | | 

ps | 200c I 
[csourTi {|CSECT | | 
| [Ds ,100c | 
| INA }CSECT | i 
{ }pc J A(CSOUT1) i 
| INB |CSECT | | 
i jpc | AC INA) j 
| [pce | A(MAITNPROG) | 
| {pc {ACINB) | 
Lethe Se ea Br Se Sar Hae ee ee eee een 4 


Statement 1 is used to generate a CSECT 
statement for statement 5. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 10. Therefore, 
&SYSECT is assigned the value INB for 
macro instruction OUTER2Z in statement 10. 





INB is substituted for 6&SYSECT when it 
appears in statement 7. 
&SYSLIST -- Macro Instruction Operand 

The system variable symbol 6SYSLIST 


provides the programmer with an alternative 
to symbolic parameters for referring to 
positional macro instruction operands. 


&6SYSLIST and symbolic parameters may be 
used in the same macro definition. 


&SYSLIST(n) may be used to refer to the 
nth positional macro instruction operand. 
In addition, if the nth operand is a 
sublist, then &SYSLIST (n,m) may be used 
to refer to the mth operand in the sublist, 
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where n and m may be any arithmetic 
expressions allowed in the operand field 
of a SETA statement. M may be equal to or 
greater than 1 and N has a range of 1 to 
200. 


The type, length, scaling, integer, and 
count attributes of §SYSLIST(n) and 
SSYSLIST(n,m) and the number attributes of 
§SYSLIST(n) and &SYSLIST may be used in 
conditional assembly instructions. 
N'&SYSLIST may be used to refer to the tot- 
al number of positional operands in a macro- 
instruction statement. N'&6SYSLIST(n) may 
be used to refer to the number of operands 
in a sublist. If the nth operand is 
omitted, N' is zero; if the nth operand is 
not a sublist, N' is one. 

The following procedure is used to 
evaluate N'&SYSLIST: 


1. A sublist is considered to be one operanc 


2. The count includes specifically omitted 
(by means of commas) operands. 


Examples: 


Macro Instruction N'&SYSLIST 
MAC K1=DS 

MAC ,K1=DC 

MAC FULL,,F,('1','2'),KIL=DC 
MAC , 

MAC 


ON BF O 


Attributes are discussed in Section 7 


under “Attributes.” 


KEYWORD MACRO DEFINITIONS AND INSTRUCTIONS 





Keyword macro definitions provide the 
programmer with an alternate way of prepar- 
ing macro definitions. 


A keyword macro definition enables a 
programmer to reduce the number of operands 
in each macro instruction that corresponds 
to the definition, and to write the oper- 
ands in any order. 


The macre instructions that correspond 
to the macro definitions described in Sec- 
tion 7 (hereinafter called positional 
macro instructions and positional macro 
definitions, respectively) require the 
operands to be written in the same order as 
the corresponding symbolic parameters in 
the operand field of the prototype state- 
ment. 


In a keyword macro definition, the pro- 
grammer can assign standard values to any 
symbolic parameters that appear in the 


operand field of the prototype statement. 
The standard value assigned to a symbolic 
parameter is substituted for the sympolic 
parameter, if the programmer does not write 
anything in the cperand field of the macro 


instructicn to correspond to the symbolic 
parameter. 
When a keyword macro instruction is 


written, the programmer need only write one 
operand for each symbolic parameter whose 
value he wants to change. 


Keyword macro definitions are 
the same way as positional 
definitions, except that the prototype 
statement is written differently and 
€SYSLIST may not be used in the definition. 
The rules for preparing positional macro- 
definitions are in Section 7. 


prepared 
macro 


Keyword Prototype 


The format of this statement is: 


Geeta nd ee Pence ias pes wanes tag ee 1 
| Name [Operation |Operand | 
~-------~--- {-----------}---~------------4 
{A symbolic |A symbol |One or more | 
|parameter | {operands of the | 
jor blank | |form described | 
| | | below, separated | 
| | | by commas 

boos See Wf S oo Sosa Pascale lesesol ee J 


Each operand must consist of a symbolic 
parameter, immediately followea by an equal 
sign and optionally followed by a standard 


value. This value must not include a 
keyword. 
A standard value that is part of an 


operand must immediately follow the equal 


Sign. 


Anything that may be used as an operand 
in a macro instruction except variable 
symbols, may be used as a standard value in 
a keyword prototype statement. The rules 
for forming valid macro instruction oper- 
ands are detailed in Section 8. 


The following are valid keyword proto- 
type operands. 


& READER= 
6 LOOP2=SYMBOL 
&ES4U==F'4096' 
The following are invalid keyword proto- 
type operands. 


CARDAREA (no symbolic parameter) 
&TYPE (no equal sign) 
&TWO =123 (equal sign does not 


immediately follow 

symbolic parameter) 
(standard value does 

not immediately follow 

equal sign) 


&SAREA= X'189A' 
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The following keyword prototype state- 
ment contains a symbolic parameter in the 


name field, and four operands in the oper- 
and field. The first two operands contain 
standard values. The mnemonic operation 
code is MOVE. 

se Tse ae ee eT pee eS ea a oe 
[Name |Operation |Operand | 
p-—- =~ fenccna meee fom ce eran nnn n ne 4 
[&N | MOVE | 6R=2, &A=S, T=, 6F= | 
loeSte ae ae ee Se J 


Keyword Macro Instruction 


After a programmer has prepared a key- 
word macro definition he may use it by 
writing a keyword macro instruction. 

The format of a keyword macro 
instruction is: 

Ce ea Wasnt eye ee ey Te a 7 
|Name | Operation|Operand | 
pomn nena 4$--------- 4$--------------------- 1 


JA symbol,|]Mnemonic |Zero or more operands | 
|Sequence |operation|of the form described| 
{symbol, |code |pbelow, separated by | 


Jor blank | | commas | 
Coes tooo Passel Be, 5 pp ee Te ee J 


Each operand consists of a 
immediately followed by an equal 
an optional 


keyword 
Sign and 
value which may not include a 


keyword. Anything that may be used as an 
operand in a positional macre instruction 
may be used as a value in a keyword 


macro-instruction. The rules for forming 
valid positional macro instruction operands 
are detailed in Section 8. 


A keyword consists of one through seven 
letters and digits, the first of which must 
be a letter. 


The keyword part of each keyword macro 
instruction operand must correspond to one 
of the symbolic parameters that appears in 
the operand field of the keyword prototype 
statement. A keyword corresponds to a 
symbolic parameter if the characters of the 
keyword are identical to the characters of 
the symbolic parameter that follow the 
ampersand. 


The following are valid keyword macro 
instruction operands. 


LOOP 2=SYMBOL 
S4==F'4096' 
TO= 
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The following are invalid keyword macro- 
instruction operands. 
&X4F2=0(2,3) (keyword does not begin 
with a letter) 
(keyword is more than 
seven characters) 
=(TO(8), (FROM)) (no keyword) 


CARDAREA=A+2 


The operands in a keyword macro- 
instruction may be written in any order. 
If an operand appeared in a keyword 
prototype statement, a corresponding oper- 
and does not have to appear in the keyword 
macro-instruction. If an operand is omit- 
ted, the comma that would have separated it 
from the next operand need not be written. 


The following rules are used to replace 
the symbclic parameters in the statements 
of a keyword macro-definition. 


1. If a symbolic parameter appears in the 
name field of the prototype statement, 
and the name field of the macro- 
instruction contains a symbol, the 
symbolic parameter is replaced by the 
symbol. If the name field of the 
macro-~instruction is blank or contains 
a sequence symbol, the symbolic 
parameter is replaced by a null char- 
acter value. 


2. If a symbolic parameter appears in the 
operand field of the prototype state- 
ment, and the macro-instruction con- 
tains a keyword that corresponds to 
the Symbolic parameter, the value 
assigned to the keyword replaces the 
symbolic parameter. 


3. If a symbolic parameter was assigned a 
Sstangard value by a prototype state- 
ment, and the macro-instruction does 
not contain a keyword that corresponds 
to the symbolic parameter, the stand- 
ard value assigned to the synibolic 
parameter replaces the symbolic param- 
eter. Otherwise, the symbolic param- 
eter is replaced by a null character 
value. 


Note: If a standard value is a self- 
defining term the type attribute assigned 
to the standard value is the letter N. If 
a standard value is omitted the type 
attribute assigned to the standard value is 
the letter O. All other standard values 
are assigned the type attribute U. 


fhe following keyword macro~definition, 
keyword macro-instruction, and generated 
statements illustrate these rules. 


Statement 1 assigns the standard values 
2 and S to the symbolic parameters &R and 
éA, respectively. Statement 6 asSigns the 
values FA, FB, and THERE to the keywords T, 
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F, and A, respectively. The symbol HERE is 
used in the name field of statement 6. 


Since a symbolic parameter (&N) appears 
in the name field of the prototype state- 
ment (statement 1), and the corresponding 


characters (HERE) of the macro-instruction 
(statement 6) are a symbol, &6N is replaced 
by HERE in statement 2. 
aac ToS eae ee eee ee 
|Name |Operation |Operand | 
}-----}~----------}---------------------- : 
| | MACRO | | 
1 |é&N | MOVE |&R=2, 6A=S, &T=, &F= | 
2 |&N {ST |&R, 6A | 
3 | |L |&R,&F | 
u | | st |&R, éT | 
5 | |L |éR, 6A | 
| | MEND | | 
}----- fernnnn n= | epursegea sne a aaa a 4 
6 |HERE | MOVE | T=PA, F=FB, A=THERE | 
pea—a=— o-oo nnn { 
|HERE |ST |2, THERE 
| [L |2,FB | 
| | st |2,FA | 
| [i [2, THERE | 
ban Se pee eR ei an eS a OSs Tots htc Jj 
Since 6&T appears in the operand field, 


of statement 1, and statement 6 contains 
the keyword (T) that corresponds to &T, the 
value assigned to T (FA) replaces &T in 
statement 4, Similarly, FB and THERE 
replace &F and 6A in statement 3 and in 
statements 2 and 5, respectively. Note 
that the value assigned to 6A in statement 
6 is used instead of the value assigned to 
6A in statement 1. 


Since 6R appears in the operand field of 
Statement i, and statement 6 does not 
contain a corresponding keyword, the value 
assigned to 6R (2), replaces &R in state- 
ments 2, 3, 4, and 5. 


Operand Sublists: The value assigned to a 
keyword and the standard value assigned to 
a symbolic parameter may be an operand 
sublist. Anything that may be used as an 
operand sublist in a positional macro- 
instruction may be used as a value in a 
keyword macro-instruction and as a standard 
value in a keyword prototype statement. 


The rules for forming valid operand 
sublists are detailed in Section 8 under 
"Operand Sublists." 

Keyword Inner Macro Instructions: Keyword 


and positional inner macro instructions may 
be used as model statements in either 
keyword or positional macro definitions. 


MIXED-MODE MACRO DEFINITIONS AND 
INSTRUCTIONS 


Mixed-mode macro- definitions allow the 
programmer to use the features of keyword 
and positional macro definitions in the 
same macro definition. 


Mixed-mode macro definitions are pre- 
pared the same way aS positional macro 
definitions, except that the prototype 
statement is written differently. If &SYS- 


LIST is used, it refers only to the posi- 
tional operands in the prototype. Sub- 
scripting past the last positional para- 
meter will yield an empty string and a type 
attribute of "O". The rules for preparing 
positional macro definitions are in Section 
7. 


Mixed-Mode Prototype 


The format of this statement is: 


| Name joperacien loperana | 
}----~---~-- }-------~---}-~-----~--------- 
JA symbolic {A symbol {Two or more ae 
{parameter | Jands of the form | 
for blank | {described below, | 
| | |Sseparated by | 
| | | comnas | 
betes St Buco Se 3eyse > ties anc ose sles lS J 


The operands 
positional and 
statements. All the 
must precede the 


must be valid operands of 
keyword prototype 
positional operands 
first keyword operand. 


The rules for forming positional operands 
are discussed in Section 1, under 
"Macro-Instruction Prototype." The rules 
for forming keyword operands are discussed 


above under “Keyword Prototype." 


The following sample mixed-mode 
prototype statement contains three posi- 
tional operands and two keyword operands. 


(oS er ae ee 1 
| Name TOperaeien|Operand | 
| 6&N [mous ee &P,6R,&TO=, &F= | 
We os ae Ne i ali is i aa a a aes 4 
Mixed-Mode Macro-Instruction 


The format of a mixed-mode 


instruction is: 


macro- 
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|A symbol, |Mnemonic |Zero or more operands | 
[sequence |operation|Jof the form described | 
{[Ssymbol, |code {|below, Separated by | 
[on blank | | commas | 
SoU ete Bo ee oS ee ead 


The operand field consists of two parts. 
The first part corresponds to the 
positional prototype operands. This part 
of the operand field is written in the same 
way that the operand field of a positional 
macro~instruction is written. The rules 
for writing positional macro-instructions 
are in Section 8. 


The second part of the operand field 
corresponds to the keyword prototype oper- 
ands. This part of the operand field is 
written in the same way that the operand 
field of a keyword macro-instruction is 
written. The rules for writing keyword 


macro-instructions are described above 
under "Keyword Macro-Instruction." 

The following mixed-mode macro- 
definition, mixed-mode macro-instruction, 
and generated statements illustrate these 
facilities. 
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|Name joperation| Operand | 
}---~--}--~------ foe nennnnc nanan nnn nan a= : 
| | MACRO | | 
1 [é6N | MOVE | &TY,&P,6R,&TO=,6F= | 
[éN |STETY | 6&R,SAVE | 
| | L&ETY { &R, &P&F | 
| [STETY | 6&R,&Pé&TO | 
| {LETY | &R,SAVE | 
aac Sra nara Ee peace acing oes ame | 
2 |HERE |MOVE | H,,2,F=FB,TO=FA { 
een Eee ae aging Seige 
[HERZ |STH | 2,SAVE | 
| [LH | 2,FB | 
| |STH | 2,FA | 
| |LH | 2,SAVE | 
ee en ip Set A oe Sa ee i a 4 
The prototype statement (statement 1) 


contains three positional operands 
and &R) and two keyword operands (&TO and 
éF). In the macro instruction (statement 
2) the positional operands are written in 
the same order as the positional operands 
in the prototype statement (the second 
operand is omitted). The keyword operands 
are written in an order that is different 
from the order of keyword operands in the 
prototype statement. 


(&TY,6&P, 


Mixed-mode inner macro instructions may 
be used as model statements in mixed-mode, 
keyword, and positional macro-definitions. 


Extended Features of the Macro Language 103 


Keyword and positional inner macro- 
instructions may be used as model 
statements in mixed-mode macro definitions. 


MACRO DEFINITION COMPATIBILITY 





Macro definitions prepared for use with 
the other System/360 assemolers having 
macro language facilities may be used with 


104 


the Operating System/360 assembler provided 


that all SET symbols are defined in an 
appropriate LCLB, GBLA, GBLB, or GBLC 
statement. The AIFB and AGOB instructions 
will be processed by the Operating 


System/360 assembler the same way that the 
AIF and AGO instructions are processed. 
AIFB and AGOB instructions will cause the 
count set up by the ACTR instructions to be 
decremented in exactly the same way as the 
AGO and AIF instructions. 
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APPENDIX 
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APPENDIX 


APPENDIX 


A: 


Bs 


Cs 


J: 


CHARACTER CODES 


HEXADECIMAL-DECIMAL NUMBER CONVERSION TABLE 


MACHINE-INSTRUCTION FORMAT 


MACHINE-INSTRUCTION MNEMONIC OPERATION CODES 


ASSEMBLER INSTRUCTIONS 


SUMMARY OF CONSTANTS 


MACRO LANGUAGE SUMMARY 


SAMPLE PROGRAM 


ASSEMBLER LANGUAGES--FEATURES COMPARISON CHART 


SAMPLE MACRO DEFINITIONS 


APPENDIX A: CHARACTER CODES 


Saat aS eee aa a aaa ae aaa ary a, aaa a a | 
8-Bit | Character Set | | | I 
BCD | Punch | | Hexa- | Printer | 
Code | Combination | Decimal | Decimal { Graphics 
[------------ fo-—~--~--=------- $+-------- toaann=--- {-----~----------- { 
00000000 |{ 12,0,9,8,1 | 0 | 00 | { 
00000001 | 12,9,1 | 1 | 01 | | 
00000010 | 12,9,2 | 2 | 02 | 
00000011 {| 12,9,3 | 3 | 03 | | 
00000100 {| 12,9,4 | 4 | 04 | | 
00000101 [| 12,9,5 | 5 | 05 | | 
00000110 | 12,9,6 | 6 | 06 { | 
00000111 | 12,9,7 | 7 | 07 | 
00001000 | 12,9,8 | 8 | 08 { | 
00001001 | 12,9,8,1 | 9 | 09 | 
00001010 j 12,9,8,2 | 10 | OA | | 
00001011 | 12,9,8,3 | 11 { OB | | 
00001100 | 12,9,8,4 | 12 | oc | | 
00001101 | 12,9,8,5 | 13 | OD | | 
00001110 | 12,9,8,6 l 14 | OE | 
00001111 | 12,9,8,7 | 15 | OF | | 
00010000 | 12,11,9,8,1 | 16 | 10 | 
00010001 | 11,9,1 | 17 | 11 | 
00010010 |{ 11,9,2 I 18 | 12 | 
00010011 | 11,9,3 | 19 | 13 | | : 
00010100 | 11,9,4 | 20 | 14 | | 
00010101 { 11,9,5 | 21 | 15 | 
00010110 | 11,9,6 | 22 | 16 { 
00010111 | 11,9,7 | 23 | 17 | | 
00011000 | 11,9,8 | 24 | 18 | | 
00011001 | 11,9,8,1 | 25 | 19 | 
00011010 { 11,9,8,2 | 26 ( 1A | 
00011011 | 11,9,8,3 | 27 | 1B | | 
00011100 |{ 11,9,8,4 | 28 | 1c { 
00011101 | 11,9,8,5 | 29 I 1D | | 
00011110 | 11,9,8,6 { 30 | 1E | 
00011111 | 11,9,8,7 | 31 | 1F | 
00100000 | 11,0,9,8,1 | 32 | 20 | | 
00100001 | 0,9,1 | 33 | 21 | 
00100010 | 0,9,2 | 34 | 22 { 
00100011 | 0,9,3 | 35 | 23 | 
00100100 | 0,9,4 | 36 | 24 | | 
00100101 | 0O,9,5 | 37 { 25 | | 
00100110 | 0O,9,6 | 38 | 26 | | 
00100111 {| 0,9,7 | 39 | 27 | | 
00101000 | 0,9,8 | 40 | 28 | 
00101001 | 0,9,8,1 | 41 | 29 | | 
00101010 | 0,9,8,2 | 42 | 2A | 
00101011 |{| O0O,9,8,3 | 43 | 2B | 
00101100 | 0,9,8,4 | 44 | 2c | 
00101101 | 0O,9,8,5 | 45 | 2D | | 
00101110 | 0,9,8,6 | 46 | 2E | | 
00101111 | 0O,9,8,7 | 47 I 2F | 
00110000 | 12,11,0,9,8,1 | 48 ( 30 | | 
00110001 | 9,1 | 49 | 31 | | 
00110010 | 9,2 | 50 | 32 | | 
SoS es Wie oe oe ee oe Pee uo oe Se ee 
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as Seay ee a ee | ee oe ge Pye POT ee A OB erg SL pe OI ee pate yee 


fF Soins ote 


10€ 


8-Bit 
BCD 
Code 


00110011 
00110100 
00110101 
00110110 
00110111 
00111000 
00111001 
00111010 
00111011 
00111100 
00111101 
00111110 
00111111 
01000000 
01000001 
01000010 
01000011 
01000100 
01000101 
01000119 
01000111 
01001000 
01001001 
01001010 
01001011 
01001100 
01001101 
01001110 
01001111 
01010000 
01010001 
01010010 
01010011 
01010100 
01010101 
01010110 
01010111 
01011000 
01011001 
01011010 
01011611 
01011100 
01011101 
01011110 
01011111 
01100000 
01100001 
01100010 
01100011 
01100100 
01100101 
01100110 
01100111 
01101000 
01101001 
01101010 
01101011 


I 


| 
| 
+ 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
i 
| 
\ 
{ 
| 
\ 
| 
{ 
| 
| 
| 
| 
| 
| 
I 
| 
| 
\ 
| 
| 
i 
| 
| 
1 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
\ 
| 
\ 
| 
| 
| 
\ 
| 
4 


Character Set 
Punch 
Combination 


wowonwnonVonwnwnnownworn 
es ss es we es sw Pewee 


DODOMMDMADANAMN SW 


sa *® 8 = 8% & 8&8 
SDM EF WNP 


DAAMEFWNE 


es 8 @ @ 8 eis 


SOAUFWwNHPUOWUWwuUUOWUWO.! 


pa a a a ee eS eS a ee 


Decimal 


Hexa- 
Decimal 


Printer 
Graphics 


blank 


(period) 


+nAs 


#it 


pro Sren eS oS emaeaae aa ie ae aaa a Toe Ts ae TES o se See :) 

8-Bit {| Character Set | | | 

BCD | Punch | | Hexa- | Printer 

Code | Combination | Decimal | Decimal | Graphics 
}---~-------- fonona-------+- === tron aaaa = aa aa fronnn---------=-- { 
} 61101100 | O0,8,4 | 108 | 6c | % | 
1 OT10T702 4 0,855 ! 109 | 6D | | 
; 61101110 }] 0,8,6 { 110 | £65 | | 
1 01101111 | 0,8,7 } 111 |  6F { 
| 01110000 | 12,11,0 | 112 | 70 | | 
+ 91210001 [{ 12,11,0,9,1 1 443 4 7 | | 
| 01110010 | 12,11,0,9,2 } 114 | 72 { | 
i 021110011 | 12,11,0,9,3 | 115 | 73 | | 
f 01110100 | 12,11,0,9,4 | 116 | 74 | | 
| 01110101 | 12,11,0,9,5 | 117 75 | | 
; 01110110 | 1212,11,0,9,6 } 118 | 76 | | 
} 01110111 | 12,11,0,9,7 { 119 | 77 | | 
{ 01111000 | 12,11,0,9,8 | 120 | 78 | | 
{ 01111001 | 8,1 | 121 | 79 | { 
f. OLTTOLO ° |) 28-2 } 122 | 7A | 
{ 01111011 | 8,3 | 123 | 7B | # | 
| 01111100 | 8,4 } 126 | Te } a | 
! 01131101 | 8,5 | 125 | 7D {| ' (apostrophe) | 
{ 01111110 | 8,6 | 126 | TE | = 
$ 01111111 | 8,7 | 127 | #7F | { 
} 10000000 | 12,0,8,1 { 128 4} 80 | | 
} 10000001 | 12,0,1 | 129 | 81 | | 
| 10000010 | 12,0,2 } 130 { 82 | | 
{| 10000011 | 12,0,3 ; 131 | 83 | | 
} 10000100 | 12,0,4 { 132 | 84 { { 
| 10000101 | 12,0,5 { 133 | 85 | | 
{ 10000110 j 12,0,6 { 1348 {| 86 | | 
; 10000111 | 12,0,7 | 135 | 87 | j 
* 10001000 | 12,0,8 ; 136 | 88 | | 
i 210001001 | 12,0,9 | 137 | 89 | l 
; 10001010 | 12,0,8,2 { 138 | 8A | | 
} 10001011 {| 12,0,8,3 } 139 | 8B | 
{ 10001100 | 12,0,8,4 } 140 | 8c { | 
: 10001101 | 12,0,8,5 | 144 | 8D | 
} 10001110 | 12,0,8,6 | 142 | 8E | | 
; 40001111 | 12,0,8,7 { 143 | 8F | | 
; 10010000 } 12,11,8,1 | 144 { 90 i | 
{ 40010001 | 12,11,1 } 145 | 91 | | 
: 10010010 | 12,11,2 |} 146 | 92 | | 
} 10010011 | 12,11,3 { 147 | 93 | | 
{ 10010100 | 12,11,4 | 148 { 94 | i 
{ 40010101 | 12,11,5 { 149 | 95 | 
£ 10010110 |{ 12,11,6 | 150 | 96 | | 
{ 10010111 | 12,11,7 } 1514 | 97 | | 
410011000 | 12,11,8 | 152, | 98 | | 
; 10011001 | 12,11,9 } 153 | 99 | | 
f 10014010" | <12,11,8,2 f 154 | 9A | 
} 10041011 j 12,11,8,3 | 155 [ 9B { | 
{ 10011100 } 12,11,8,4 } i156 | 9e | 
} 10011101 { 12,11,8,5 | 157 | 9D i | 
1 410031110 | 12,11,8,6 } 158 | 95 i | 
{ 16011111 | 12,11,8,7 } 159 | 9F { | 
i 10100000 j 11,0,8,1 } 160 | AO | | 
i; 10100001 [{ 11,0,1 | 161 | At | | 
} 10100010 | 11,0,2 | 162 | A2 | | 
{ 10100011 |} 11,0,3 | 163 | A3 | 
{| 10100100 | 11,0,4 } 164 | as | | 
bo Sse i Se, le es aie a Ss ns ne es So ee ee ee ee eed 
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(aor Se he aaa aaa a aaa ToS Sat i cacao Tons ee ye 1 
| 8-Bit | Character Set {| \ | | 
| BCD | Punch | | Hexa- | Printer | 
| Code | Combination | Decimal | Decimal | Graphics | 
}------------ }-------=-------~- $--------- }--------- }----------------- 4 
j 10100101 4| 11,0,5 {| 165 | AS | | 
{ 10100110 | 11,0,6 | 166 | A6 { | 
j 10100111 | 11,0,7 | 167 | AT | | 
{ 10101000 | 11,0,8 {; 168 | AB | | 
j 10101001 | 11,0,9 } 169 | ag | 
] 10101010 | 11,0,8,2 | 170 | AA | j 
{ 10101011 | 11,0,8,3 | 171 =|) AB | | 
} 10101100 | 11,0,8,4 | 172, | AC | 
} 10101101 | 11,0,8,5 i 173. | AD | | 
{ 10101110 | 11,0,8,6 | 174 {| AE | | 
{ 10101111 | 11,0,8,7 | 175 | AF | | 
} 10110000 | 12,11,0,8y1 } 176 | BO | | 
} 10110001 | 12,11,0,1 { 177 |i | { 
{ 10110010 | 12,11,0,2 | 178 | B2 | | 
} 20110011 {| 12,11,0,3 | 179 j|  B3 { | 
} 10110100 |] 12,11,0,4 | 180 | Ba | | 
; 40110101 | 12,11,0,5 | 181 | BS { | 
j 10110110 | 12,11,0,6 } 182 | B6 i | 
{ 40110112 | 12,11,0,7 | 183 | B7 | | 
{ 10111000 { 12,11,0,8 } 184 | BB | j 
{ 10111001 { 12,11,0,9 | 185 |} Bg | | 
| 20111010 | 12,11,0,8,2 | 186 | BA | | 
} 210111011 [{ 12,11,0,8,3 | 187 | BB | | 
} 10111100 {| 12,11,0,8,54 | 188 | BC | | 
} 20111101 | 12,11,0,8,5 } 189 | BD | | 
{ 210111110 | 12,11,0,8,6 | 190 | BE | | 
{ 201112111 | 12,11,0,8,7 | 191 | BF | | 
j 11000000 | 12,0 |} 192 | co { | 
{ 121000001 | 12,1 | 193 | cl | A { 
{11000010 | 12,2 } 194 | c2 | B { 
{ 11000011 | 12,3 i} 195 | C3 rae: | 
} 11000100 | 12,4 } 196 4 cy } D. | 
{ 11000101 | 12,5 } 197 jf cS | E i 
, 11000110 | 12,6 | 198 j C6 | F i 
{ 11000111 {| 12,7 | 199 {ct 1G | 
} 110010C0 | 12,8 | 200 | cB | H | 
} 11001001 | 12,9 { 202 | c9 } I 

{ 11001010 j 12,0,9,8,2 b 202 | -@n | | 
} 11001011 | 12,0,9,8,3 { 203 | CB | | 
{ 11001100 | 12,0,9,8,4 | 204 | ce | ] 
{ 11001161 | 12,0,9,8,5 f. 208.) ep | | 
} 11001110 | 12,0,9,8,6 |} 206 | CE | 

{ 11001111 | 12,0,9,8,7 | 207 |  cF | | 
{ 11010000 | 11,0 { 208 | po | { 
{ 11010001 | 11,1 | 209 i Di | J i 
| 11010010 | 11,2 | 210 | D2 | K | 
J} 11010011 | 11,3 | 211 [| D3 | L | 
{11010100 [| 11,4 | 212 | D4 1M | 
j 11010101 | 11,5 | 213) «| DS { N | 
{ 41010110 | 11,6 | 214 =| D6 rae) | 
j 11010112 4} 11,7 | 215 | D7 | P | 
} 11011000 | 11,8 { 216 | vB } 2 | 
} 11011001 | 11,9 | 217 | v9 1 R | 
{ 11011010 | 12,11,9,8,2 } 218 | DA | | 
} 11011011 | 12,11,9,8,3 {} 219 4} DB | { 
{ 11011100 | 12,11,9,8,4 | 220 | ove | | 
{| 11011102 | 12,11,9,8,5 L.. 228 O48 BB | | 
eae aS pono il St dose sos US doses ose se busca seh ees eo J 
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CS ese PINS fee Peet we ad ace aK |” sy arr ES MS gt ye ee ce ae 
| 8-Bit {| Character Set | { | 
| BCD | Punch | | Hexa- | Printer 
| Code | Combination | Decimal | Decimal | Graphics 
a Jona nn nnnnn anna nee fonann--=- fomnn nn nnn pom nnnnnn nnn nn 
| 11011110 | 12,11,9,8,6 | 222 | DE l 
| 11011111 | 12,11,9,8,7 | 223 { ODF | 
{ 11100000 | 0O,8,2 | 224 | EO | 
| 11100001 f{ 11,0,9,1 } 225 | E21 | 
|} 11100010 | 0,2 | 226 | £2 | s 
} 11100011 | 0,3 {} 227 | £3 | T 
] 11100100 | 0,4 | 228 | EY | U 
} 121100101 {| 0,5 {| 229 | &ES Iv 
| 11100110 { 0,6 | 230 | E6 { W 
} 12100111 | 0,7 { 231 | =§7 | x 
| 11101000 | 0,8 | 232 | E8 | Y 
} 11101001 | 0,9 {} 233 | £9 |Z 
| 11101010 11,0,9,8,2 | 234 | EA | 
[| 111017011 ]| 11,0,9,8,3 | 235 | EB | 
i 11101100 | 11,0,9,8,4 | 236 | EC | 
| 11101101 | 11,0,9,8,5 | 237 | ED | 
} 11101110 { 11,0,9,8,6 | 238 | &EE | 
| 11101111 | 11,0,9,8,7 | 239 | EF | 
| 11110000 | 0 } 240 | FO | 0 
H 11110001 | 1 | 241 | FL { 1 
| 11110010 | 2 | 242 | F2 { 2 
| 11110011 | 3 | 243 | F3 | 3 
| 11110100 | 4 | 244 | F4 1 4 
| 11110101 | 5 | 245 | F5 | 5 
{ 11110110 | 6 } 246 | F6 | 6 
{ 11110111 | 7 | 247 | FT | 7 
] 11111000 | 8 | 248 | F8 | 8 
j 11111001 | 9 | 249 | F9 | 9 
| 11111010 | 12,11,0,9,8,2 | 250 | FA | 
| 111113011 | 12,11,0,9,8,3 {| 251 | FB | 
| 11111100 l 12,11,0,9,8,4 | 252 | FC | 
| 11111101 | 12,11,0,9,8,5 | 253 | FD | 
| 11111110 | 12,11,0,9,8,6 i 254 — | FE | 
| 11111111 { 12,11,0,9,8,7 | 255 | FF | 
Coe ee tn hh ns wb. ne oe 1. 1 ee ee eee 
Special Graphic Characters 
© Cent Sign * Asterisk > Greater-than Sign 
+ Period, Decimal Point ) Right Parenthesis ? Question Mark 
< Less-than Sign + Semicolon : Colon 
( Left Parenthesis — Logical NOT # Number Sign 
+ Plus Sign - Minus Sign, Hyphen @ At Sign 
{Vertical Bar, Logical OR / Slash » Prime, Apostrophe 
& Ampersand * Comma = Equal Sign 
! Exclamation Point % Percent "Quotation Mark 
$ Dollar Sign _ Underscore 
Examples Type Bit Positions 
01 23 4567 Zone Punches 
PF Control Character 00 00 0100 12-9 5 4 
% Special Graphic Ot 10 1100 0-8-4 
R Upper Case 11 O1 1001 W-9 
a Lower Case 10 00 0001 12 -0 i ] 
Control! Character, 00 11 0000 





function not yet 
assigned 
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APPENDIX B: HEXADECIMAL-DECIMAL NUMBER CONVERSION TABLE 





The table in this appendix provides for direct conversion of decimal and hexadecimal 
numbers in these ranges: 


(Clea sea Se SS Neer a ee 1 
| Hexadecimal | Decimal | 


Decimal numbers (0000-4095) are given within the 5-part table. The first two characters 
(high-order) of hexadecimal numbers (000-FFF) are given in the lefthand column of the 
table; the third character (x) is arranged across the top of each part of the table. 


To find the decimal equivalent of the hexadecimal number 0C9, look for 0C in the left 
column, and across that row under the column for x = 9. The decimal number is 0201. 


To convert from decimal to hexadecimal, look up the decimal number within the table 
and read the hexadecimal number by a combination of the hex characters in the left 
column, and the value for x at the top of the column containing the decimal number. For 
example, the decimal number 123 has the hexadecimal equivalent of 07B; the decimal 
number 1478 has the hexadecimal equivalent of 5Cé6é. 


For numbers outside the range of the table, add the following values to the table 


Pee Sa 5 Saas eee ees 1 
| Hexadecimal | Decimal | 
p--==--=-=====- f--=====---- 4 
| 1000 | 4096 | 
| 2000 | 8192 | 
| 3000 | 12288 { 
{ 4000 | 16384 J} 
| 5000 | 20480 | 
| 6000 | 24576 | 
| 7000 } 28672 | 
| 8000 | 32768 | 
| 9000 |} 36864 | 
| A000 | 40960 =| 
| BO000 } 45056 4} 
| coco | 49152 
| DGOO | 53248 | 
{ E000 | 573uu | 
{ F000 | 61440 | 
becuse Saeko A pea eae J 
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ooot 0002 0003 0004 0005 0006 0007 0008 0009 0010 0011 0012 
0017 0018 0019 0920 0021 0022 0023 0024 0025 0026 0027 0028 
0033 0034 0035 0036 0037 0038 0039 0040 0041 0042 0043 0044 
004% 0050 0051 0052 0053 0054 0055 0056 0057 0058 0059 0060 


0065 0066 0067 0068 0069 0070 0071 0072 0073 0074 0075 0076 
0081 0082 0083 0084 0085 0086 0087 0088 0089 0090 0091 0092 
0097 0098 0099 0100 0101 0102 0103 0108 0105 0106 0107 0108 
0113 0114 0115 0116 0117 0118 0119 0120 0121 0122 0123 0124 


0129 0130 0131 0132 0133 0134 0135 0136 0137 0138 0139 0140 
0145. 0166 0147 0148 0149 9150 0151 0152 0153 0154 0155 0156 
0161 0162 0163 0164 0165 0166 0167 0168 0169 0170 0171 0172 
0177 0178 0179 0180 0181 0182 0183 0184 0185 0186 0187 0188 


0193 0194 0195 0196 0197 0198 0199 0200 0201 0202 0203 0204 
0203 0210 0211 0212 0213 0214 0215 0216 0217 0218 0219 0220 
0225 0226 0227 0228 0229 9230 0231 0232 0233 0234 0235 0236 
0241 0242 0243 0244 0245 0246 0247 0248 0249 0250 0251 0252 


0257 0258 0259 0260 0261 0262 0263 0264 0265 0266 0267 0268 
0273 0274 0275 0276 0277 0278 0279 0280 0281 0282 0283 0284 
0289 0290 0291 0292 0293 0294 0295 0296 0297 0298 0299 0300 
0305 0306 0307 0308 0309 0310 0311 0312 0313 0314 0315 0316 


0321 0322 0323 0324 0325 0326 0327 0328 0329 0330 0331 0332 
0337 0338 0339 0340 0341 0342 0343 0344 0345 0346 0347 0348 
0353 0354 0355 0356 0357 0358 0359 0360 0361 0362 0363 0364 
0369 0370 0371 0372 0373 0374 0375 0376 0377 0378 0379 0380 


0385 0386 0387 0388 0389 0390 0391 0392 0393 0394 0395 0396 
0401 0402 0403 O4u0u 0405 0406 0407 0408 0409 0410 ou11 0412 
0417 0418 0419 0420 0421 0422 0423 0424 0425 0426 0427 0428 
0433 0434 0435 0436 0437 0438 0439 0440 0444 0442 0443 0444 


O4N9 0450 0451 0452 0453 04us4 0455 0456 0457 0458 0459 0460 
0465 0466 0467 0468 0469 0470 0471 472 0473 0474 0475 0476 
0481 0482 0483 0&84 0485 0486 0487 0488 0489 0490 0491 0492 
0497 0498 0499 0500 0501 0502 0503 0504 0505 0506 0507 0508 


0513 0514 0515 0516 0517 0518 0519 0520 0521 0522 0523 0524 
0529 0530 0531 0532 0533 0534 0535 0536 0537 0538 0539 0540 
0545 0S46 0547 0548 0549 0550 0551 0552 0553 0554 0555 0556 
0561 0562 0563 0564 0565 0566 0567 0568 0569 0570 0571 0572 


0577 0578 0579 0580 0581 0582 0583 0584 0585 0586 0587 0588 
0593 0594 0595 0596 0597 0598 0599 0600 0601 0602 0603 0604 
0609 0610 0611 0612 0613 0614 0615 0616 0617 0618 0619 0620 
0625 0626 0627 0628 0629 0630 0631 0632 0633 0634 0635 0636 


0641 0642 0643 0644 064s 0646 0647 0648 0649 0650 0651 0652 
0657 0658 0659 0660 0661 0662 0663 0664 0665 0666 0667 0668 
0673 0674 0675 0676 0677 0678 0679 0680 0681 0682 0683 0684 
0689 0690 0691 0692 0693 0694 0695 0696 0697 0698 0699 0700 


0705 0706 0707 0708 0709 0710 o711 0712 0713 0714 0715 0716 
0721 0722 0723 0724 0725 0726 0727 0728 0729 0730 0731 0732 
0737 0738 0739 0740 0741 0742 0743 0744 0745 0746 0747 0748 
0753 0754 0755 0756 0757 0758 0759 0760 0761 0762 0763 0764 


0769 0770 0771 0772 0773 0774 0775 0776 0777 0778 0779 0780 
0785 0786 0787 0788 0789 0790 0791 0792 0793 0794 0795 0796 
0601 0802 0803 0804 0805 0806 0807 0808 0809 0810 0811 0812 
0817 0818 0819 0820 0821 0822 0823 0824 0825 0826 0827 0828 


0833 0834 0835 0836 0837 0a38 0839 0840 0841 0842 0843 0864 
0849 0850 0851 0852 0853 0854 0855 0856 0857 0858 0859 0860 
0865 0866 0867 0868 0869 0870 0871 0872 0873 0874 0875 0876 
0881 0882 0883 0884 088s 0686 0887 0888 0889 0890 0891 0892 


0897 0898 0899 0900 0901 0902 0903 0904 0905 0906 0907 0908 
0913 0914 0915 0916 0917 0918 0919 0920 0921 0922 0923 0924 
0929 0930 0931 0932 0933 0934 0935 0936 0937 0938 0939 0940 
0945 0946 0947 0948 0949 0950 0951 0952 0953 0954 0955 0956 


0961 0962 0963 0964 0965 0966 0967 0968 0969 0970 0971 0972 
0977 0978 0979 0980 0981 0982 09863 0984 0985 0986 0987 0988 
0993 0994 0995 0996 0997 0998 0999 1000 1001 1002 1003 1004 
1009 1010 1011 1012 1013 1016 1015 1016 1017 1018 1019 1020 
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20468 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 
2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 
2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 
2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 


2112 2113 2174 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 
2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 
2144 2145 2146 2047 2148 21469 2150 2151 2152 2153 2154 2155 2156 
2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2472 


2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 
2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 
2208 22093 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 
2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 


2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 
2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 
2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 
2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 





2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 
2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 
2326 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 
2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 


2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 
2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 
2460 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 
2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 


2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 
2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 
2464 2465 2466 2467 2468 2469 2470 2471 2472 2473 24746 2475 2476 
2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 





2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 
2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 
2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 
2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 


2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 
2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 
2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 
2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 


2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 
2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 
2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 
2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 


2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 
2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 
2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 
2736 2737 2738 2739 2740 27414 2742 2743 2744 2745 2746 2747 2748 


2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 
2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2786 
2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 
2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 


2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 
2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 
2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 
2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 


2880 2881 2882 2883 2884 2885 2886 2867 2888 2889 2890 2891 2892 
2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 
2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 
2928 2929 2930 2931 2932 2933 2934 2935 2936 2937 2938 2939 2940 


2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 
2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 
2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 
2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 


3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 
3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 
3040 3041 3042 3043 3044 30485 3046 3047 3048 3049 3050 3051 3052 
3056 3057 3058 3059 3050 3061 3062 3063 3064 3065 3066 3067 3068 
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3072 
3088 
3104 
3120 


3136 
3152 
3168 
3184 


3200 
3216 
3232 
3248 


3264 
3280 
3296 
3312 


3328 
3344 
3360 
3376 


3392 
3408 
3424 
3440 


3456 
3472 
3488 
3504 


3520 
3536 
3552 
3568 


3584 
3600 
3616 
3632 


3648 
3664 
3680 
3696 


3712 
3728 
3744 
3760 


3776 
3792 
3808 
3824 


3840 
3856 
3872 
3888 


3904 
3920 
3936 
3952 


3968 
3984 
4000 
4016 


4032 
4048 
4064 
4080 


3073 
3089 
3105 
3121 


3137 
3153 
3169 
3185 


3201 
3217 
3233 
3249 


3265 
3281 
3297 
3313 


3329 
3345 
3361 
3377 


3393 
3409 
3425 
3441 


3457 
3473 
3489 
3505 


3521 
3537 
3553 
3569 


3585 
3601 
3617 
3633 


3649 
3665 
3681 
3697 


3713 
3729 
3745 
3761 


3777 
3793 
3809 
3825 


3841 
3857 
3873 
3889 


3905 
3921 
3937 
3953 


3969 
3985 
4001 
4017 


4033 
4049 
4065 
4081 


3074 
3090 
3106 
3122 


3138 
3154 
3170 
3186 


3202 
3218 
3234 
3250 


3266 
3282 
3298 
3314 


3330 
3346 
3362 
3378 


3394 
3410 
3426 
3442 


3458 
3474 
3490 
3506 


3522 
3538 
3554 
3570 


3586 
3602 
3618 
3634 


3650 
3666 
3682 
3698 


3714 
3730 
3746 
3762 


3778 
3794 
3810 
3826 


3842 
3858 
3874 
3890 


3906 
3922 
3938 
3954 


3970 
3986 
4002 
4018 


4034 
4050 
4066 
4082 


3075 
3091 
3107 
3123 


3139 
3155 
3171 
3187 


3203 
3219 
3235 
3251 


3267 
3283 
3299 
3315 


3331 
3347 
3363 
3379 


3395 
3411 
3427 
3443 


3459 
3475 
3491 
3507 


3523 
3539 
3555 
3571 


3587 
3603 
3619 
3635 


3651 
3667 
36 83 
3699 


3715 
3731 
3747 
3763 


3779 
3795 
3811 
3827 


3843 
3859 
3875 
3891 


3907 
3923 
3939 
3955 


3971 
3987 
4003 
4019 


4035 
4051 
4067 
4083 


3076 
3092 
3108 
3124 


3140 
3156 
3172 
3188 


3204 
3220 
3236 
3252 


3268 
3284 
3300 
3316 


3332 
3348 
3364 
3380 


3396 
3412 
3428 
3444 


3460 
3476 
3492 
3508 


3524 
3540 
3556 
3572 


3588 
3604 
3620 
3636 


3652 
3668 
3684 
3700 


3716 
3732 
3748 
3764 


3780 
3796 
3812 
3828 


3844 
3860 
3876 
3892 


3908 
3924 
3940 
3956 


3972 
3988 
4004 
4020 


4036 
4052 
4068 
4084 


3077 
3093 
3109 
3125 


3141 
3157 
3173 
3189 


3205 
3221 
3237 
3253 


3269 
3285 
3301 
3317 


3333 
3349 
3365 
3381 


3397 
3413 
3429 
3445 


3461 
3477 
3493 
3509 


3525 
3541 
3557 
3573 


3589 
3605 
3621 
3637 


3653 
3669 
3685 
3701 


3717 
3733 
3749 
3765 


3781 
3797 
3813 
3829 


3845 
3861 
3877 
3893 


3909 
3925 
3941 
3957 


3973 
3989 
4005 
4021 


4037 
4053 
4069 
4085 


6 


3078 
3094 
3110 
3126 


3142 
3158 
3174 
3190 


3206 
3222 
3238 
3254 


3270 
3286 
3302 
3318 


3334 
3350 
3366 
3382 


3398 
3414 
3430 
3446 


3462 
3478 
3494 
3510 


3526 
3542 
3558 
3574 


3590 
3606 
3622 
3638 


3654 
3670 
3686 
3702 


3718 
3734 
3750 
3766 


3782 
3798 
3814 
3830 


3846 
3862 
3878 
3894 


3910 
3926 
3942 
3958 


3974 
3990 
4006 
4022 


4038 
4054 
4070 
4086 
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3079 
3095 
3111 
3127 


3143 
3159 
3175 
3191 


3207 
3223 
3239 
3255 


3271 
3287 
3303 
3319 


3335 
3351 
3367 
3383 


3399 
3415 
3431 
3447 


3463 
3479 
3495 
3511 


3527 
3543 
3559 
3575 


3591 
3607 
3623 
3639 


3655 
3671 
3687 
3703 


3719 
3735 
3751 
3767 


3783 
3799 
3815 
3831 


3847 
3863 
3879 
3895 


3911 
3927 
3943 
3959 


3975 
3991 
4007 
4023 


4039 
4055 
4071 
4087 


3080 
3096 
3112 
3128 


3144 
3160 
3176 
3192 


3208 
3224 
3240 
3256 


3272 
3288 
3304 
3320 


3336 
3352 
3368 
3384 


3400 
3416 
3432 
3448 


3464 
3480 
3496 
3512 


3528 
3544 
3560 
3576 


3592 
3608 
3624 
3640 


3656 
3672 
3688 
3704 


3720 
3736 
3752 
3768 


3784 
3800 
3816 
3832 


3848 
3864 
3880 
3896 


3912 
3928 
3944 
3960 


3976 
3992 
4008 
4024 


4040 
4056 
4072 
4088 


3081 
3097 
3113 
3129 


3145 
3161 
3177 
3193 


3209 
3225 
3241 
3257 


3273 
3289 
3305 
3321 


3337 
3353 
3369 
3385 


3401 
3417 
3433 
3449 


3465 
3481 
3497 
3513 


3529 
3545 
3561 
3577 


3593 
3609 
3625 
3641 


3657 
3673 
3689 
3705 


3721 
3737 
3753 
3769 


3785 
3801 
3817 
3833 


3849 
3865 
3881 
3897 


3913 
3929 
3945 
3961 


3977 
3993 
4009 
4025 


4out 
4057 
4073 
4089 


A 


3082 
3098 
3114 
3130 


3146 
3162 
3178 
3194 


3210 
3226 
3242 
3258 


3274 
3290 
3306 
3322 


3338 
3354 
3370 
3386 


3402 
3418 
3434 
3450 


3466 
3482 
3498 
3514 


3530 
3546 
3562 
3578 


3594 
3610 
3626 
3642 


3658 
3674 
3690 
3706 


3722 
3738 
3754 
3770 


3786 
3802 
3918 
3834 


3850 
3866 
3882 
3898 


3914 
3930 
3946 
3962 


3978 
3994 
4010 
4026 


4042 
4058 
4o74 
4090 


B 


3083 
3099 
3115 
3131 


3147 
3163 
3179 
3195 


3211 
3227 
3243 
3259 


3275 
3291 
3307 
3323 


3339 
3355 
3371 
3387 


3403 
3419 
3435 
3451 


3467 
3483 
3499 
3515 


3531 
3547 
3563 
3579 


3595 
3611 
3627 
3643 


3659 
3675 
3691 
3707 


3723 
3739 
3755 
3771 


3787 
3803 
3819 
3835 


3851 
3867 
3883 
3899 


3915 
3931 
3947 
3963 


3979 
3995 
4011 
4027 


4043 
4059 
4075 
4091 


Cc 


3084 
3100 
3116 
3132 


3148 
3164 
3180 
3196 


3212 
3228 
3244 
3260 


3276 
3292 
3308 
3324 


3340 
3356 
3372 
3388 


3404 
3420 
3436 
3452 


3468 
3484 
3500 
3516 


3532 
3548 
3564 
3580 


3596 
3612 
3628 
3644 


3660 
3676 
3692 
3708 


3724 
3740 
3756 
3772 


3788 
3804 
3820 
3836 


3352 
3868 
3884 
3900 


3916 
3932 
3948 
3964 


3980 
3996 
4012 
4028 


4oug 
4060 
4076 
4092 


D 


SUBD 
3101 
3117 
3133 


3149 
3165 
3181 
3197 


3213 
3229 
3245 
3261 


3277 
3293 
3309 
3325 


3341 
3357 
3373 
3389 


3405 
3421 
3437 
3453 


3469 
3485 
3501 
3517 


3533 
3549 
3565 
3581 


3597 
3613 
3629 
3645 


3661 
3677 
3693 
3709 


3725 
3741 
3757 
3773 


3789 
3805 
3821 
3837 


3853 
3869 
3885 
3901 


3917 
3933 
3949 
3965 


3981 
3997 
4013 
4029 


4045 
4061 
4077 
4093 


E 


3086 
3102 
3118 
3134 


3150 
3166 
3182 
3198 


3214 
3230 
3246 
3262 


3278 
3294 
3310 
3326 


3342 
3358 
3374 
3390 


3406 
3422 
3438 
3454 


3470 
3466 
3502 
3518 


3534 
3550 
3566 
3582 


3598 
3614 
3630 
3646 


3662 
3678 
3694 
3710 


3726 
3742 
3758 
3774 


3790 
3806 
3822 
3838 


3854 
3870 
3886 
3902 


3918 
3934 
3950 
3966 


3962 
3998 
4014 
4030 


4046 
4062 
4078 
4094 





F 


3087 
3103 
3119 
3135 


3151 
3167 
3183 
3199 


3215 
3231 
3247 
3263 


3279 
3295 
3311 
3327 


3343 
3359 
3375 
3391 


3407 
3423 
3439 
3455 


3471 
3487 
3503 
3519 


3535 
3551 
3567 
3583 


3599 
3615 
3631 
3647 


3663 
3679 
3695 
3711 


3727 
3743 
3759 
3775 


3791 
3607 
3823 
3439 


3855 
3671 
3887 
3903 


3919 
3935 
3951 
3967 


3983 
3999 
4015 
4031 


4O4u7 
4063 
4079 
4095 
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APPENDIX C: MACHINE-INSTRUCTION FORMAT 





ASSEMBLER OPERAND 
BASIC MACHINE FORMAT FIELD FORMAT APPLICABLE INSTRUCTIONS 


All RR instructions 
except BCR,SPM, 
and SVC 


8 
Operation ae 
Code (See Notes 1,6,8, 
and 9) 


R1,D2(X2,B2) 
R1,D2(,B2) 
R1,S2(X2) 
R1,S2 


All RX instructions 
except BC 


M1,D2(X2,B2) 
M1,D2(,B2) 
M1,S2(X2) 
M1,S2 
(See Notes 1,6,8, 
and 9) 


R1,R3,D2(B2) BXH, BXLE,LM,STM, LCL, STCL 
R1,R3,S2 


8 
Operation R1,D2(B2) All shift instructions 
Code R1,S2 


R1,M3,D2(B2) ICM,STCM,CLM 
R1,M3,S2 
(See Notes 1-3,7, 
8,and 9) 
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sr 


ss 
8 8 4 
Operation 
Code L| Bl 








ASSEMBLER OPERAND 





BASIC MACHINE FORMAT FIELD FORMAT APPLICABLE INSTRUCTIONS 
8 8 4 12 All SI instructions 
Operation D1(B1l,I2) except those listed 
Code I2 {Bl ] D1 Si,t2 for other SI formats 
8 4 12 
Operation D1(Bl) LPSW,SSM,TIO,TCH, 
Code Bl] Dl Sl TS 
16 4 12 
Two-byte D1(Bl) SCK,STCK,STIPD,SIOF, 
Operation Sl STIDC,SIO,HIO, HDV 
Code Bl | DL (See Notes 2,3,6, 
eee 7,8, and 10) 


8 4); 4] 4 4 D1(L1,Bl) ,D2(L2,B2) 
Operatio S1(L1) ,S2(L2 
Code L1{L2] Bl] D1l|B2 | D2 ta ite) 





PACK,UNPK,MVO,AP, 
CP,DP,MP,SP,ZAP 





D1(L,Bl) ,D2(B2) NC ,OC,XC,CLC,MVC,MVN, 
MVZ,TR,TRT,ED,EDMK 


S1(L) ,S2 








8 
Operation 
Code 


D1(L1,B1) ,D2(B2) ,13 SRP 
S1(L1),S82, 13 
$1,82,13 
(See Notes 2,3,5,6, 
7 and 10) 











Notes for Appendix C: 





l. 


ui 


10. 
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Rl, R2, and R3 are absolute expressions that specify general or floating-point reg- 
isters. The general register numbers are 0 through 15; floating-point register nunm- 
bers are 0, 2, 4, and 6. 


Dl and D2 are absolute expressions that specify displacements. A value of 0 - 4095 
may be specified. 


Bl and B2 are absolute expressions that specify base registers. Register numbers are 
o- 15. 


X2 is an absolute expression that specifies an index register. Register numbers are 
O15. 


L, Ll, and L2 are absolute expressions that specify field lengths. An L expression 
can specify a value of 1 - 256. Ll and L2 expressions can specify a value of 1 - 16. 
In all cases, the assembled value will be one less than the specified value. 


I, I2, and I3 are absolute expressions that provide immediate data. The value of I 
and I2 may be 0 - 255. The value of I3 may be 0 - 9. 


Sl and S2 are absolute or relocatable expressions that specify an address. 

RR, RS, and SI instruction fields that are blank under BASIC MACHINE FORMAT are not 
examined during instruction execution. The fields are not written in the symbolic 
operand, but are assembled as binary zeros. 

Ml and M3 specify a 4-bit mask. 

In IBM System/370 the SIO, HIO, HDV and SIOF operation codes occupy one byte and the 


low order bit of the second byte. In all other systems the HIO and SIO operation 
codes occupy only the first byte of the instruction. 


APPENDIX Dz MACHINE~INSTRUCTION MNEMONTC OPERATION CODES 


table of the 
for all machine 


This appendix contains a 
mnemonic operation codes 
instructions that can be represented in 
assembler language, including extended mne- 
monic operation codes. It is in alphabetic 


order by instruction. Indicated for each 
instruction are botn the mnemonic and 
machine operation codes, explicit and 


implicit operand formats, voroqram interrup- 
tions possible, and condition code set. 


The column headings in this appendix and 
tne information each column provides fol- 
low. 
Instruction: This column contains the name 
of the instruction associated with the 
mnemonic operation code. 


Mnemonic Operation Code: This column gives 
the mnemonic operation code for the machine 
instruction. This is written in the opera- 
tion field when coding the instruction. 





Machine Operation Code: This column con- 
tains the hexadecimal equivalent of the 
actual machine operation code. The opera- 


tion code will appear in this form in most 
storage dumps and when displayed on the 
system control panel. For extended mnemon- 
ics, this column also contains the mnemonic 
code of the instruction from which the 
extended mnemonic is derived. 


Operand Format: This column shows the 
symbolic format of the operand field in 


both explicit and implicit form. For both 
forms, Ri, R2, and R3 indicate general 
registers in operands one, two, and three 


X2 indicates a general req- 
index register in the 
second operand. Instructions which require 
an index register (X2) but are not to be 
indexed are shown with a 0 replacing X2. 
L, Ll, and L2 indicate lengths for either 
operand, operand one, and operand two re- 
spectively. Ml and M3 indicate a four-bit 
mask in operand, one and three, respect-— 
ively. I, I2, and I3 indicate immediate 
data eight bits long (I and I2) or four 
bits long (13). 


For the 
indicate a 
indicate a 
and two. 


respectively. 
ister used aS an 


explicit format, Dl and D2 
displacement and Bl and B2 
base register for operands one 


For the implicit format, Dl, B1 and D2, 
B2 are replaced by S1 and S2 which indicate 
a storage address in operands one and two. 


Type of Instruction: This column gives the 
basic machine format of the instruction 
(RR, RX, SI, or SS). If an instruction is 
included in a special feature or is an 
extended mnemonic this is also indicated. 


Program Interruptions __Possible: This 
column indicates the possible program 
interruptions for this instruction. The 
abbreviations used are: A - Addressing, 


S - Specification, Ov - Overflow, P - Pro- 
tection, Op - Operation (if feature is not 
installed), and Other - other interruptions 
which are listed. The type of overflow is 
indicated by: D - Decimal, E - Exponent, 
or F - Fixed Point. 


Code 


Condition Set: The condition ccdes 


sét as a result of this instruction are 
indicated in this column. (See legend 
following the table). 
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\ , Mnemonic | Machine 

nstruction é . 
Operation | Operation 

Code Code 

Add A 5A 

Add AR 1A 

Add Decimal AP FA 

Add Hal fword AH 4A 

Add Logical AL 5E 

Add Logical ALR 1E 

Add Normalized, Extended AXR 36 

Add Normalized, Long AD 6A 

Add Normalized, Long ADR 2A 

Add Normalized, Short AE 74 

Add Normalized, Short AER 3A 

Add Unnormalized, Long AW 6E 

Add Unnormalized, Long AWR 2E 

Add Unnormalized, Short AU 7E 

Add Unnormalized, Short AUR 3E 

And Logical N 34 

And Logical Nc D4 

And Logical NR 14 

And Logical Immediate NI 94 

Branch and Link BAL 45 

Branch and Link BALR 05 

Branch on Condition BC 47 

Branch on Condition BCR 07 

Branch on Count 8CT 46 

Branch on Count BCTR 06 

Branch on Equal BE 47(BC 8) 

Branch on High BH 47(BC 2) 

Branch on Index High BXH 86 

Branch on Index Low or Equal BXLE 87 

Branch on Low BL 47(BC 4) 

Branch if Mixed BM 47(BC 4) 

Branch on Minus BM A7(BC 4) 

Branch on Not Equal BNE 47(BC 7) 

Branch on Not High BNH 47(BC 13) 

Branch on Not Low BNL 47(BC 11) 

Branch on Not Minus BNM 47(BC 11) 

Branch on Not Ones BNO 47(BC 14) 

Branch on Not Plus BNP 47(BC 13) 

Branch on Not Zeros BNZ 47(BC 7) 

Branch if Ones BO 47(BC 1) 

Branch on Overflow BO 47(BC 1) 

Branch on Plus BP 47(BC 2) 

Branch if Zeros BZ 47(BC 8) 

Branch or, Zero BZ 47(BC 8) 

Branch Unconditional B 47(BC 15) 

Branch Unconditional BR O7(BCR | 

Compare Algebraic c 59 

Compare Algebraic CR 19 

Compare Decimal cP FO 

Compore Halfword CH 49 

Compare Logical cL 55 

Compare Logical cLc DS 

Compare Logical CLR 15 

Compare Logical CLM BD 

Characters under 

Mask 

Compare Logical | mmediate CLI 95 

Compare Logical long CLCL OF 

Compare, Long cD 6? 

Compare, Long COR 29 

Compare , Short CE 79 

Compare, Short CER 39 

Convert to Binary CcVvB 4F 

Convert to Decimal [cv | 4E 
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e Operand Format (Add) 
















Explicit 
RI, D2(X2, B82) or RI, 02(, B2) 
R1,R2 

DI(L1, BI), D2(L2, B2) 
R1,D2(X2, B2)or RI, 02(, B2) 
R1, D2(X2, B2)or RI, D2(, 82) 


RI,R2 
R1,R2 


RI, D2(X2, B2)or RI, D2(, B2) 
RI,R2 
RI, D2(X2, B2)or R1, 02(, B2) 
R1,R2 


R1, 02(X2, B2)or RI, D2(, B2) 
RI,R2 
R1, D2(X2, B2)or RI, D2(, B2) 
RI,R2 
RI, 02(X2, B2)or RI, D2(, 82) 


DI(L, 81), 02(B2) 
RI, R2 

D1(BI), 12 

R1, D2(X2, B2)or RI, D2(, B2) 
RY,R2 


(,B2) 


21, D2(X2, B2)or R1, D2(, B2) 
R1,R2 
D02(X2, B2)or D2(, B2) 


DO2(X2,B2)or D2(, B2) 
R1,R3, D2(B2) 
R1,R3, D2(B2) 
52(X2, B2)or D2(, B2) 
02(X2, B2)or D2(, B2) 


D2(X2, B2)or D2(, 62) 
D2(X2, B2)or D2(, 62) 
D2(X2, B2)or 02(, B2) 
ID2(X2, B2)or D2(,B2 ) 
D2(X2, B2)or D2(, B2) 


D2(X2, B2)or D2(, B2) 
12(X2, B2)or D2(, B2) 
D2(X2, B2)or D2(, B2) 
D2(X2, B2)or 02(, B2) 
02(X2, B2)or D2(, B2) 


2(X2, B2)or D2(, B2) 
D2(X2, B2)or D2(, B2) 
D2(X2, B2)or D2(, B2) 
02(X2, 82)or D2(, B2) 
R2 





Rl, D2(X2, B2)or RI, D2(, B2) 
RV, R2 

O1(L1, BI), O2(L2, B2) 

R1, D2(X2, B2)or RI, D2(, B2) 
R1,D2(X2, B2)or R1, D2(,B2) 


DI(L, Bl), 02(B2) 
R1,R2 


R1, M3, D2(B2) 


O1(B1), 12 
RT, R2 


R1,D2(X2, B2)or R1, D2(, B2) 
R1,R2 


RI, D2(X2, B2)jor RI, D2(,B2) 
RI,R2 
R1, D2(X2, B2)or RI, D2(,B2) 





Operand Format 


Implicit 





R1, S2(X2) or RI, $2 


SI(L1), S2(L2)or SI, $2 


RI, S2(X2)or R1, S2 
RT, $2(X2)or R1, S2 


R1,S2(X2)or RI, $2 


RI, S2(X2)or R1, S2 


RI, S2(X2Jor RI, $2 
RY, S2(X2Z}or RI, S2 
RI, $2(X2)or RI, $2 
SUL), $2. or $1, 82 
$1,12 

R1, 52(X2)or RI, S2 
MI, $2(X2)or MI, $2 


RI, S2(X2)or R1, $2 


S2(X2) or $2 
S2(X2) or $2 
R1,R3,82 

RI,R3, $2 

S2(X2) or S2 
$2(X2) or S2 
$2(X2) or $2 
$2(X2) or $2 
$2(X2) or S2 
$2(X2) or $2 
$2(X2) or S2 
$2(X2) or S2 
§2(X2 or $2 
$2(X2) or 52 
$2(X2) or 82 
$2(X2) or S2 
$2(X2) or S2 
S$2(K2) or S2 
$2(X2) or S2 
$2(X2) or & 


R1,$2(X2 or RI, $2 


ST(L1), S2(L2 or $1, $2 


R1, S2(X2)or RI, S2 
R1, $2(X2)or RI, $2 


SI(L), $2 or $1, $2 
R1, M3, $2 

51,12 

R1, $2(X2)or RI, $2 
R1, S2(X2)or RI, $2 


RI, S2(X2)or RI, $2 
R1,$2(X2)or RI, S2 




















Type of 


Instruction 


Instruction 












Add RX 


Add RR 
Add Decimal SS, Decimal 
Add Hal fword RX 


Add Logical RX 


Add Lagical RR 
Add Normalized, Extended | RR Floating Pt. 


Add Normalized, Long RX, Floating Pt. 
Add Normalized, Long RR, Floating Pt. 
Add Normalized, Short RX,Floating Pt. 


Add Normalized, Short RR,Floating Pt. 


















Add Unnormalized, Long RX, Floating Pt. 
Add Unnormalized, Long RR,Floating Pt. 
Add Urnormalized, Short RX, Floating Pt. 
Add Unnormolized, Short RR, Floating Pt. 
Add Logic.:l RX 
4 

And Logical SS 

And Logical RR 

And Logica! Immediate St 

Branch and Link RX 

Branch and Link RR 

Branch on Condition RX 

Branch on Condition RR 

Branch on Count RX 

Branch on Count RR 

Branch on Equal RX, Ext. Mnemonic 
Branch on High RX, Ext. Mnemonic! 
Branch on Index High RS 

Branch on Index Low or Equal] RS 

Branch on Low RX, Ext Mnemonic 
Branch if Mixed RX, Ext. Mnemonic! 
Branch on Minus RX, Ext. Mnemonic} 
Branch on Not Equal RX, Ext. Mnemonic 
Branch on Not High RX, Ext. Mnemonic! 
Branch on Not Low RX, Ext, Mnemonic 
Branch on Not Minus RX, Ext.Mnemonic 
Branch on Not Ones RX, Ext. Mnemonic 
Branch on Not Plus RX, Ext. Mnemonic} 
Branch on Not Zeros RX, Ext. Mnemonic] 
Branch if Ones RX, Ext. Mnemonic 
Branch on Overflow RX, Ext. Mnemonic] 
Branch on Plus RX, Ext. Mnemonic 
Branch if Zeros RX Ext. Mnemonic 
Branch on Zero RX, Ext. Mnemonic 


Branch Unconditional RX, Ext. Mnemonic 
Branch Unconditional RR, Ext. Mnemonic 





Compare Algebraic RX 
Compare Algebraic RR 
Compare Decimal SS, Decimal 
Compare Halfword RX 
Compare Logical RX 





Compare Logical Ss 
Compare Logical RR 


Compare Logical RS 
Characters under 
Mask 


Compare Logical Immediate | SI 


Compare Logical Long RR 


RX,Floating Pt. 
RR, Floating Pt. 









Compare, Long 
Compare, Long 












RX,Floating Pt. 
RR, Floating Pt. 
RX 

RX 


Compare , Short 
Compare, Short 
Convert to Binary 

Convert to Decimal 







e Condition Code Set (Add) 


Program Interruption 
























































Condition Code Set 












Overflow 
Overflow 
Overflow 
Overflow 
Sum 0 0) 


Sum 0 (1) 
















ZEST PSETZTE 


uwnAanrRrAD 
a ai al ll 





ZZZZZ2 ZZZZZ Zz 















ZZZZ2Z ZZZZZ ZZZZZ AZZZAZAZ AZZAZZ ZLRRK 
ZZZ2Z22Z2 Z2ZZZ2Z2Z 2Z2Z22Z22 ZZZZ2 22222 Z22 
ZZZ2227 Z2Z2722 22222 Z2Z2Z2ZZ22 422222 22 


ZZZZQ2Z Z2ZZZ2 LZAZ22Z 















NNNNN 
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[ Sn ‘ a Mnemonic | Machine i | 
Instruction Operation | Operation Operand Format 
Code Code Explicit Implicit 

Divide D 50 R1, D2(X2, B2) or R1, D2(, B2) Rl, S2(X2) or R1,S2 
Divide DR 1D R1,R2 

Divide Decimal » DP FD DI, (LI, BI), D2(L2, B2} SILT), $2(L2)or S1,S2 
Divide, Long ; DD 6D R1,D2(X2, 82), or RT, D2(, B2) R1, $2(X2) or RT, S2 
Divide, Long DDR 2D R1,R2 

Divide, Short DE 7D R1, D2(X2, B2)or Rt, D2(, B2) RI, S2(X2) or RI, S2 
Divide, Short DER 3D R1,R2 

Edit ED DE DI(L, Bl), 02(B2) S1(L), $2 or ST, S2 
Edit and Mark | EDMK DF DI(L, Bl), D2(B2) SI(L), $2 or ST, $2 
Exclusive Or ‘e,s 57 R1,D2(X2, B2) or R1, D2(, B2} R1, $2(X2) or R1,S2 
Exclusive Or XC D7 OI(L, 81), D2(B2) SI(L), $2 or $1,82 
Exclusive Or XR V7 R1,R2 

Exclusive Or Immediate i Xd 97 DI(B1),12 $1,12 

Execute Ee 44 R1,D2(X2,B2) or RI, D2(,B2) | R1,S2(X2) RI, S2 
Halve, Long ' HDR 24 R1,R2 

Halve, Short HER 34 R1,R2 

Halt Device | HDV ge! pt, B1 S 

Halt 1/0 HIO ge! $1481) 

Insert Character Ic 43 R1,D2(X2, B2) or R1, D2(, B2) R1, $2(X2) or R1,S$2 
Insert Characters : ICM BF R1, M3, D2(B2) RI, M3, S2 

under Mask i 

Insert Storage Key | ISK 09 R1,R2 

Load Pook 58 RI, D2(X2, B2) or RI, D2(, B2) R1,$2(X2) or RI, S2 
Load LR 18 RI,R2 

Load Address LA 41 Ri, D2(X2, B2) or RI, D2(, B2) R1, $2(X2) or R1,S2 
Load cand Test LTR 12 R1,R2 

Load and Test, Long LTDR 22 R1,R2 

Load and Test, Shert LIER 32 R1,R2 

Load Complement LCR 13 R1,R2 

Load Complement, Long LCDR 23 R1,R2 

Load Complement, Short LCER 33 R},R2 

Load Control LCTL B7 R1,R3, D2(B2) RI, R3, S2 

Load Halfword LH 48 R1,D2(X2, B2) or RT, D2(,B2) | RI,S2(X2) or RI, S2 
Load, Long LD 68 R1, 02(X2, B2) or RI, D2(,B2) |R1,S2(X2) or R1,S2 
Load, Long LDR 28 RI,R2 

Load Multiple LM 98 R1,R3, D2(B2) R1,R3, $2 

Load Negative LNR VW RI,R2 

Load Negative, Lang LNOR 2) R1,R2 

Load Negative, Short LNER 31 R1,R2 

Load Positive LPR 10 R1,R2 

Load Positive, Long LPDR 20 R1,R2 

Load Positive, Short LPER 30 R1,R2 

Lowel PS LPSW 82 01(B1) st 

Load Rounded, Extended LRDR 25 RI, R2 

to Long 

Load Rounded, Long to LRER x i) RI, R2 

Short 

Load, Short LE 78 R1,D2(X2, B2) or R1,D2(,B2) | Rt,S2(X2) or R1,S2 
Load, Short LER 38 R1,R2 

Move Characters MVC b2 O1(L, Bl), 02(B2) SI(L), $2 or 51,52 
Move Immediate MvVI 92 O1(B1), 12 S1,12 

Move Long MVCL OE RI, R2 

Move Numerics MVN D1 O1(L, Bl}, D2(B2) ST(L), $2 or $1,82 
Move with Offset MVO Fl D1(L1,81), D2(L2, B2) ST(L1), S2(L2)or $1, $2 
Move Zones MVZ D3 O1(L, Bl), D2(B2) SI{L), $2 or $1,82 
Multiply M 5C R1,D2(X2, B2)or RI, D2(,B2) | RI, S2(X2) or R1,S$2 
Multiply MR 1c R1,R2 

Multiply Decimal MP FC DI(L1,B1), D2(L2, B2) SI(LT), S2(L2) or $1, 52 
Multiply Extended MXR 26 Ri, R2 

Mulitply Hal fword MH 4C R1,D2(X2,B2) or R1,D2(,B2) {RI,S2(X2) or RI, S2 
Multiply, Long MD 6C 81,D2(X2,B2) or R1,D2(,B2) |R1I,S2(X2) or RI, S2 
Multiply, Long MDR 2C R1,R2 

Multiply, Long to MXD 67 kl, D2(X2, 82) or R},D2(,B2) | R1,52(X2) or R1(S2) 
Extended 

Multiply, Long to 27 RT, R2 

Extended 

Multiply, Short 7c R1,D2(X2, B2) or RI, D2(,B2) | R1,S2(X2) or RI, S2 
Multiply, Short 3c R1,R2 

No Operation 47(BC 0) | D2(X2, B2) or D2(, B2) $2(X2) or $2 





® Operand Format (Divide) 
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e Type of 
Instruction Race ies 
Divide RX 
Divide RR 
Divide Decimal SS, Decimal 
Divide, Long RX,Floating Pt. 
Divide, Long RR, Floating Pt. 


Divide, Short 
Divide, Short 
Edit 

Edit and Mark 
Exclusive Or 


Exclusive Or 

Exclusive Or - 
Exclusive Or Immediate 
Execute 

Halve, Long 


Halve, Short 

Halt Device 

Halt 1/O 

Insert Character 

Insert Characters under 


Mask 
Insert Storage Key 


Load 





Load 

Load Address 

Load and Test 

Load and Test, Long 
Load and Test, Short 


Load Complement 

Load Complement, Long 
Load Complement, Short 
Load Control 

Load Halfword 

Load, Long 


Load, Long 

Load Multiple 

Load Negative 

Load Negative, Long 
Load Negative, Short 





Load Positive 

Load Positive, Long 

Load Positive, Short 

Load PSW 

Load Rounded, Extended 
to Long 

Load Rounded, Long to 
Short 

Load, Short 

Load, Short 


Move Characters 
Move Immediate 
Move Long 
Move Numerics 
Move with Offset 


Move Zones 
Multiply 
Multiply 
Multiply Decimal 
Multiply Hal fword 


Multiply, Extended 


Multiply, Long/Extended 
Multiply, Long/Extended 


Multip y, Long 
Multiply, Long 
Multiply, Short 
Multiply, Short 
No Operation 











RX, Floating Pt. 
RR, Floating Pt. 
SS, Decimal 

$S, Decimal 

RX 


SS 
RR 
SI 
RX 
RR, Floating Pt. 


RR, Floating Pt. 
SI 

S| 

RX 

RS 


RR 
RX 


RR 
RX 
RR 
RR, Floating Pt. 
RR, Floating P+. 


RR 
RR, Floating Pt. 
RR, Floating Pt. 
RS 
RX 
RX, Floating Pt. 


RR, Floating Pt. 
RS 
RR 
RR, Floating Pt. 
RR, Floating Pt. 


RR 
RR, Floating Pt. 
RR, Floating Pt. 
Sl 
RR, Floating Pt. 


RR, Floating Pt. 


RX, Floating Pt. 
RR, Floating Pt. 


SS 
SI 

RR 
SS 
S$ 


ss 
RX 
RR 
$8, Decimal 
RX 


RR, Floating Pt. 
RX, Floating Prt. 
RR, Floating Pt. 


RX, Floating Pt, 
RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Prt. 
RX, Ext.Mnemonic 





® Condition Code 


Program Interruptions 
Possible 


AS YP [Op] Othe 




















x} x F 
x F 
x} x x | x D, Data 
x} x TE x B,E 
xtE x] B,E 
x] xTE x B,E 
x]E x B,E 
x x | x] Data 
x x | x} Data 
xtx 
x x 
x x 
x] x G 
x x 
x x 
A 
A 
x | x 
x|x x | A 
x |x 
x x 
x x 
F 
x x 
x x 
x|x x | x A 
x 1x 
x} x x 
x x 
x 1x 
x x 
x x 
F 
x x 
x x 
x|Xx A 
x JE x 
x TE x 
x 1X x 
x x 
x x 
x x 
x] x x x 
x x 
x x 
x x 
x | x 
x 
x |x x {| x | Data 
x 
x{eE x | B 
x |x fE[x | x} B 
x{E x | B 
x |x LE x B 
x [E x | B 
x |x JE x] B 
x |E x | B 








Set (Divide) 


Appendix D: 


Condition Code Set 























00 01 10 i 
N N N N 
N N N N 
N N N N 
N N N N 
N N N N 
N N N N 
N N N N 
S T U 
s T U 
J K 
J K 
J K 
J K 
(May be set by this instruction) 

N N N N 

N N N N 

AAM cc AAL 

DD ce GG KK 

N N N N 

uu TT SS 

N N N° N 

N N N N 

N N N N 

N N N N 

J L M 

R L M 

R L M 

P L M, fo) 
L M 

R { M 

N N N N 
N N N 

N N N N 

N N N N 

N N N N 

J L 

R L 

R l 

J M oO 

R L M 

R L M 

QQ QQ QQ QQ 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 

AAA AAB AAC AAD 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 

N N N N 
N N N N 
N N N N 
N N N N 
N N N N 
N N N N 
N N N N 

N 

N N N 











Machine-Instruction Mnemonic Operation Codes 
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TAT 
Mnemonic 





























































Instr tan Operotion bea ha Pm psranesr cunt 
Code Code Explicit Implicit 
ee ee NES 

No Operation NOPR | O7(BCR 0) | R2 
Or Logical @) 56 R1,02(X2, B2) or RI, D2(, B2) R1,S2{X2) or RI,S2 
Or Logical oc Dé DI(L, B1), D2(B2) SI(L), $2 or $1,582 
Or Logical OR 16 R1,R2 
Or Logical Immediate Ol 96 D1(B1),12 $1,12 
Pack PACK F2 DI(L1,B1), D2(L2, B2) SI(L1), S2(L2) or $1, $2 
Reod Direct RDD 85 DI(BI), 12 $1,412 
Set Clack SCK B204 D1(BI) 51 
Set Program Mask SPM 04 RI 
Set Storage Key SSK 08 R1,R2 
Set System Mask SSM 80 D1(B1 Ss] 
Shift and Round Decimal SRP FO DI(L1,B1), 02(B2), 13 SI{L1), $2, 13 or $1,S2,13 
Shift Left Double Algebraic SLOA | 8F R1, D2(B2) RI, S2 
Shift Left Double Logical SLOL | 8D RI, D2(B2) RI, 2 
Snift Left Single Algebraic SLA 8B RI, D2(B2) RI, S2 
Shift Left Single Logical SLL 89 R1, D2(B2) RT, $2 
Shift Right Double Algebraic SRDA 8E Ri, D2(B2) R1, $2 
Shift Right Doukle Logical SRDL 8c R1,D2(B2) R1, 82 
Shift Right Single Algebraic SRA 8A R1,D2(B2) RI, S2 
Shift Right Single Logical SRL 88 ' RT, D2(B2) R1,S2 
Start {/O SIO 9C D1(B1) $l 
Start 1/O Fast Release sior | 9c' D1(B1) $1 
Store ST 50 R1,D2(X2, 82) or R1,D2(,B2) | R1,S2(X2) or R1,S2 
Store Character STC 42 R1,D2(X2,B2) or RI, D2(, B82 R1,D2(X2) or R1,S2 
Store Channel! ID STIDC | B203 D1(B1) Sl 
Store Halfword STH 40 Ri,D2(X2,B2) or RL, D2(,B2) | R1,S2(X2) or RI, $2 
Store Long STD 60 Rt, 02(X2, B2) RI, $2(X2) or RT,S2 
Store Multiple STM 90 R1,R2,D2(B2} RT,R2, $2 
Store Short STE 70 R1,D2(X2,B2) or Rl, D2(, B2) R1,S2(X2) or RI, S2 
Store Characters under STCM BE R1, M3, D2(B2) R1, M3, S2 
Mask 
Store Clock STCK B205 D1(BI) $1 
Store Control STCTL | B6 R1, R3, D2(B2) R1,R3, $2 
Store CPU ID STIDP B202 D1(B1) SI 
Subtract Normalized, SXR 37 RI, R2 
Extended 
Subtract S 5B R1,D2(Xx2 RI, S2(X2) or RT,S2 
Subtract SR 1B R1,R2 
Subtract Decimal SP FB D1(L1,B1), D2(L2, B2) SI(L1), $2(L2) or 51, $2 
Subtract Halfword SH 48 R1,D2(X2, BZ) or RI, O2(,B2) | R1,S2(X2) or RI,$2 
Subtract Logical Su SF R1,D2(X2,B2) or R1,02(,B2) | R1,S2(X2) or RI, S2 
Subtract Logical SLR lF R1,R2 
Subtract Normalized, Long $D 6B R1,D2(X2, B82) or R1, D2(, B2) R1, S2(X2) or RT, $2 
Subtract Normalized, Long SDR 28 R1,R2 
Subtract Normalized, Short SE 7B R1,D02(X2, B2) or RI, D2(, B2) R1,S2(X2) or RI, $2 
Subtract Normalized, Short SER 3B RI,R2 
Subtract Unnormalized, Long SW 6F RI, 02(X2, B2) or RI, D2(, 82) RI,S2(X2) or RT, S2 
Subtract Unnormalized, Long SWR 2F R1,R2 
Subtract Unnormalized, Short SU 7F R1,D2(X2, B2) or RI, D2(,B2) | R1,S2(X2) or R1,S2 
Subtract Unnormalized, Short: SUR 3F R1,R2 
Supervisor Call svc 0A | 
Test and Set TS 93 DI(BI) 51 
Test Channel TCH oF D1(B1) $1] 
Test 1/0 TIO 9D DI(B1) SI 
Test Under Mask ™ 91 D1(B1), 12 $1,12 
Translate TR OC DI(L,B1),D2(B2) SI(L), S2 orS1, $2 
Translate and Test TRT DD Di(L, Bl), D2(B2) S1(L), $2 orSt, S2 
Unpack UNPK | F3 DI(L1,B1), D2(L2, B2) SI{L1), S2(L2) or $1, $2 
Write Direct WRD | 84 DI{B1), 12 $1,12 
Zero_and Add Decimal ZAP F8 DI(L1,B1), D2(L2, B2 SULT), S2(L2) or $1, $2 





* Operation Format (No Operation) 
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Instruction 


Ne Operation 

Or Logical 

Or Logical 

Or Logical 

Or Logical Immediate 
Pack 


Read Direct 


Set Clock 

Set Program Mask 

Set Storage Key 

Set System Mask 

Shift Left Double Algebraic 
Shift and Round Decimal 
Shift Left Double Logical 
Shift Left Single Algebraic 
Shift Left Single Logical 
Shift Right Double Algebraic 
Shift Right Double Logical 


Shift Right Single Algebraic 
Shift Right Single Logical 
Start 1/0 

Start |/O Fast Release 


Store 
Store Character 


Store Halfword 

Store Long 

Store Multiple 

Store Short 

Store Channel 1D 
Store Characters under 
Mask 

Store Clock 

Store Control 


Store CPU ID 


Subtract 


Subtract 

Subtract Decimal 
Subtract Hal fword 
Subtract Logical 
Subtract Logical 


Subtract Normalized, Long 
Subtract Normatized, Long 
Subtract Normalized, Short 
Subtract Normalized, Short 
Subtract Unnormalized, Long 
Subtract Normalized,Extended 
Subtract Unnormalized, Long 
Subtract Unnormalized, Short 
Subtract Unnormalized, Short 
Supervisor Call 

Test and Set 


Test Channel 

Test 1/O 

Test Under Mask 
Translate 
Translate and Test 


Unpack 
Write Direct 
Zero and Add Decimal 


Program Interruptions 


f 
ype Possible 


Instruction 


RX, Floating Pt. 
RS 
RX, Floating Pt. 
SI 
RS 


sl 
RS 
SI 


RX 


RR 
SS, Decimal 


RX, Floating Pt. 
RR, Floating Pt. 
RX, Floating Pt, 
RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 
RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 


mmommmommm 
x x xX KK KX KX K XK 


$$, Decimal 


® Condition Code Set (No Operation) 
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Condition Code Set 


ZOZOZ0"ZZRE ZZ SoZ 
m 


== 


ZPZZ222 ZZ S22 
=x 


<<< < > 
ZZ 
Q 


ATA RDAARADDA 
w 


a aon77 aay de eo ae a 2D RRAR 
ZzZ> ZQZ2222 ZZ QaZ 25° 2 Z Sea 5 Z Zz 


<sxxx x 


Agorer rrr ee 
3 


A> 
RSs 


ZPzzzz ZZMM™Z7Z ZEZEZZEZZZ 
Rn 


ZAZZZZ ZZ 


> 
Qa 


<<<<< 


ZOONO OHHOO £2000 0 ZZ 


ZSSSFTeSzTzEz 
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Program Interruptions Possible 


Under Ov: =D = Decimal 
E = Exponent 
F = Fixed Point 


Under Other: 
Privileged Operation 
Exporent Underflow 
Significance 
Decimal Divide 
Floating Point Divide 
Fixed Point Divide 
Execute 

GA Monitoring 
Condition Code Set 


QA ONLY 


No Carry 
Carry 
Result = 0 


Result is Not Equal to Zero 

Result is Less Than Zero 

Result is Greater Than Zero 

Not Changed 

Overflow 

Result Exponent Underflows 

Result Exponent Overflows 

Result Fraction = 0 

Result Field Equals Zero 

Result Field is Less Than Zero 

Result Field is Greater Than Zero 

Difference = 0 

Difference is Not Equal to Zero 

Difference is Less Than Zero 

Difference is Greater Than Zero 

First Operand Equals Second Operand 

AA First Operand is Less Than Second Operarid 

BB First Operand is Greater Than Second Operand 
cc CSW Stored 

DD Channel and Subchannel not Working 

EE Channel or Subchannel Busy 

FF Channel Operating in Burst Mode 

GG Burst Operation Terminated 

HH Channel Not Operational 

Ul Interruption Pending in Channel 

JJ Channel Available 

KK Not Operational 

LL Available 

MM 1/O Operation initiated and Channel Proceeding With its Execution 
NN — Nonzero Function Byte Found Before the First Operand Field is Exhausted 
OO — Last Function Byte is Nonzero 

PP All Function Bytes Are Zero 

QQ Set According to Bits 34 and 35 of the New PSW Loaded 
RR Set According to Bits 2 and 3 of the Register Specified by R1 
SS Leftmost Bit of Byte Specified =0 

TT Leftmost Bit of Byte Specified =] 

UU Selected Bits Are All Zeros; Mask is All Zeros 
VV Selected Bits Are Mixed (zeros and ones) 

WW Selected Bits Are All Ones 

XX Selected bytes are equal, or mask is zero 

YY Selected field of first operand is low 

ZZ Selected field of first operand is high 

AAA _ First-operand and second-operand counts are equal 
AAB First operand count is lower 

AAC First operand count is higher 

AAD No movement because of destructive overlap 
AAE — Clock value set 

AAF — Clock value secure 

AAG Clock not operational 

AAH Channel ID correctly stored 

AAI — Channel activity prohibited during ID 

AAJ — Clock value is valid 

AAK — Clock value not necessarily valid 

AAL — Channel working with another device 

AAM — Subchannel busy or interruption pending 

AAN Clock in error state 


N<XXSE<CAMAOQVOZFATAYTL 








* Program Interruptions Possible 
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RR Format 


Operation 


Mnemonic 


Set Program Mask 
Branch and Link 
Branch on Count 
Branch on Condition 
Set Storage Key 
Insert Storage Key 
Supervisor Cail 


Move Long 
Compare Logical Long 


Load Positive 
Load Negative 
Load and Test 
Load Complement 
AND 

Compare Logical 
OR 

Exclusive OR 
Load 

Compare 

Add 

Subtract 
Multiply 

Divide 

Add Logical 
Subtract Logical 


Load Positive (Long) 

Load Negative (Long) 

Load and Test (Long) 

Load Complement (Long) 

Halve (Long) 

Load Rounded (Extended to Long) 
Multiply (Extended) 

Multiply (Long to Extended) 
Load (Long) 

Compare (Long) 

Add Normalized (Long) 
Subtract Normalized 
Multiply (Long) 

Divide (Long) 

Add Unnormalized (Long) 
Subtract Unnormalized (Long) 


Load Positive (Short) 

Load Negative (Short) 

Load and Test (Short) 

Load Complement (Short) 

Halve (Short) 

Load Rounded (Long or Short) 
Add Normalized (Extended) 
Subtract Normalized (Extended) 
Load (Short) 


Remarks 


$/370 only 
§/370 only 


85,195,S/370 only 
85,195,S/370 only 
85,195,S/370 only 


85,195,S/370 only 
85,195,S/370 only 
85,195,S/370 only 
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RR Format 


Remarks 


Operation Name Mnemonic 
Code 










Compare (Short) 

Add Normalized (Short) 
Subtract Normalized (Short) 
Multiply (Short) 

Divide (Short) 

Add Unnormalized (Short) 
Subtract Unnormalized (Short) 





Store Halfword 
Load Address 
Store Character 
Insert Character 
Execute 

Branch and Link 
Branch on Count 
Branch on Condition 
Load Halfword 
Compare Halfword 
Add Halfword 
Subtract Halfword 
Multiply Halfword 


Convert to Decimal 
Convert to Binary 


Store 


AND 

Compare Logical 
OR 

Exclusive OR 
Load 

Compare 

Add 

Subtract 
Multiply 

Divide 

Add Logical 
Subtract Logical 


L 


N 
Cc 
Oo 
x 
L 
Cc 
A 
Ss 
M 
D 


Store (Long) 


Multiply (Long to Extended) 85,195,S/370 only 
Load (Long) 

Compare (Long) 

Add Normalized (Long) 
Subtract Normalized (Long) 
Multiply (Long) 

Divide (Long) 

Add Unnormalized (Long) 
Subtract Unnormalized (Long) 
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RX Format 
Operation 
RS,SI Format 





Remarks 


Mnemonic 







Store (Short) 


Load (Short) 

Compare (Short) 

Add Normalized (Short) 
Subtract Normalized (Short) 
Multiply (Short) 

Divide (Short) 

Add Unnormalized (Short) 


Subtract Unnormalized (Short) 





Set System Mask 


Load PSW 

Diagnose. 

Write Direct 

Read Direct 

Branch on Index High 
Branch on Index Low or Equal 
Shift Right Single Logical 
Shift Left Single Logical 
Shift Right Single 

Shift Left Single 

Shift Right Double Logical 
Shift Left Double Logical 
Shift Right Double 

Shift Left Double 


Store Multiple 

Test under Mask 

Move (Immediate) 

Test and Set 

AND (Immediate) 

Compare Logical (Immediate) 
OR (Immediate) 

Exclusive OR (Immediate) 
Load Multiple 






Start I/O, Start I/O Fast Release See Note 2 
Test I/o 
Halt I/O, Halt Device 


Test Channel 


STO,SIOF 
TIO 
HIO,HDV 
TCH 






See Note l 
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RS,SI Format 


Operation Name Mnemonic Remarks 
Code 
AT 








(First byte of two-byte operation codes) See Note 3 










Store Control 
Load Control 


S/370 only 
S/370 only 













Compare Logical Characters under Mask 
Store Characters under Mask 
Insert Characters under Mask 


S/370 only 
S/370 only 
S/370 only 









Move Numerics 
Move (Characters) 

Move Zones 

AND (Characters) 

Compare Logical (Characters) 
OR (Characters) 

Exclusive OR (Characters) 











Translate 
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SS Format 


Operation Name Remarks 


Translate and Test 
Edit 
Edit and Mark 






Shift and Round Decimal 
Move with Offset 

Pack 

Unpack 


S/370 only 


Zero and Add Decimal 
Compare Decimal 

Add Decimal 

Subtract Decimal 
Multiply Decimal 
Divide Decimal 


Note 1: Under the System/370 architecture the machine operations for Halt Device and 
Halt I/O are as follows: 


frooa 1110 XXxXx xxx9] Halt I/O HIO 
ftoor 1110 XXXxX xxx1| Halt Device HDV 


(X denotes an ignored bit position) 


Under System/360 the Halt I/O operation code is: 


hoor 1110 XXXX XXxXX 


The Halt Device instruction does not exist under this system; the second byte is com- 
pletely ignored. 
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Note 2: Under the System/370 architecture the machine operations for Start I/O and 
Start I/O Fast Release are as follows: 


1001 1100 XXXX XxXxXO0 Start I/O SIO SIo 
1001 1100 XXXX xXxXxX1l Start I/O Fast Release SIOF 
(X denotes an ignored bit position) 
Under System/360 the Start I/O code is: 
1001 1100 XXXX XXXxX 


The Start I/O Fast Release instruction does not exist under this system. The second 
byte is completely ignored. 


Note 3: The following operation codes occupy two bytes of SI~type instructions. They 
can be used on System/370 machines only. 


Name Mnemonic 


Store CPU ID 
Store Channel ID 
Set Clock 
Store Clock 








Operation 








The special Model 85, Model 195, ana System/370 instructions are supported only by the 
F Assembler. 
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APPENDIX E: ASSEMBLER INSTRUCTIONS 





ear ORR ax: SR ee Ta a a ag pe ee 4 
{|Operation| Name Entry | Operand Entry | 
}~-------- --------~--------------------——- 4{-~-------------------------+---------------- : 
|ACTR |Must not be present [An arithmetic SETA expression | 
------—-- fa- 2-2-2 nnn nnn penne nnn nnn nnn nn nnn nnn nn 
| AGO |A sequence symbol or not present|A sequence symbol | 
[AIF JA sequence symbol or not present|A logical expression enclosed in parenthe-| 
| | |ses, immediately followed by a _  sequence| 
| | | symbol | 
}--------- }---------------------+--------—- +} --- + ---------- +--+ { 
| ANOP [A sequence symbol |Must not be present | 
--------- fo----- =~ == + +--+ =f n= +4 
|Cccw {Any symbol or not present | Four operands, separated by commas | 
ie f—-------~-~---- +++ +--+ 5 +--+ f+ e+ 
| CNOP |A sequence symbol or not present|Two absolute expressions, separated by af 
| | | comma | 
~-------- }------------------------------—- }------- =f 
[COM {A sequence symbol or not present|Must not be present | 
--------- fannnnan nna nnn nn nnn np nn 
| COPY |Must not be present {A symbol i] 
--------- f= --= =~ === == === - 2-2 $= fn $n nnn 
|CSECT JAny symbol or not present |Must not be present | 
--------- }------------------=------------~}------------++------------------------------4 
|CXD * {Any symbol or not present |Must not be present | 
——-—=---- fanaa nnn nnn nnn nn nn nnn nnn nnn 
{Dc |Any symbol or not present |One or more operands, separated by commas | 
etal es eee 4---------+-~+-----~+---+~-- +--+ | be + + - | 
[DROP {A sequence symbol or not present|{One to sixteen absolute expressions, sepa-| 
| | |xated by commas | 
--------- fo-----~------------- $= - $= f= === == === + === == += === == 
|DS {Any symbol or not present [One or more operands, separated by commas 
~~------- }-----~---------~--~-------------}----~---------------------- === === === 
]DSECT { A variable symbol or an |Must not be present | 
| | ordinary symbol | | 
p~---~---- fon nnnn nn === -- = fom----- === === : 
| DXD * |A symbol |One or more operands, separated by commas | 
--------- $--------~----------~------------ }---- ------------ === == $= == === 
{EJECT |A sequence symbol or not present|Must not be present | 
--------- fanaa - ann nf nnn nn ann 
| END JA sequence symbol JA relocatable expression | 
| Jor not present Jor not present | 
-------—-- }-------~----------~----------~--}+--~------------------------------—--------= 
[ENTRY |A sequence symbol or not present{One or more relocatable symbols, separated| 
| | | by commas | 
}~~------- femme nn nanan nn nnn nn fe nnn nn nnn nnn nnn renner ene nnn nna { 
| EQU | A variable symbol or an {An absolute or relocatable expression | 
| | ordinary symbol | | 
j--------- v-+------------------------------ pa---~--—------- === == == == { 
| EXTRN {A sequence symbol or not present|One or more relocatable symbols, separated] 
| | |by commas 
}---~----- }------~------------------------- }------------------------------------~------- { 
| GBLA |Must not be present [One or more variable symbols that are to hbe| 
| | jused as SET symbols, separated by commas? | 
}--------- {----~---~----------------------- 4--------------------------------=----------- 
|GBLB |Must not be present [One or more variable symbols that are to be| 
| | Jused as SET symbols, separated by commas? | 
|--------- $---—-------------------+------— }~-------------~----~-------- = : 
|GBLC |Must not be present JOne or more variable symbols that are to hbe| 
| | Jused as SET symbols, separated by commas? | 
}--------- $------~-----------~-----------—- }-----------------------------+----—--------- : 
| IcTL |Mast not be present {One to three decimal values, separated by| 
| | | commas 

}------+-- SD hs A Ne Ss At Poe Sh Se Se i ae 4 
ti Assembler F only 
est PP le 2 ed ae a ae a a a eA ate ag Re en a Ne ee | 
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rc 


| Operation |! t 1 
Entry ; Name Entry ;, Operand Entry 
Ios F t 
, ISEQ : Must not be present Two decimal values, separated by a comma 
| LCLA Must not be present One or more variable symbols that are to 
' 1 , be used as SET symbols, separated by 
Be Seetate Sp a re eed es AC COMMAS iit Be ee ee BU eee 
‘ 1 
| LCLB Must not be present ; One or more variable symbols that are to 
\ | 1 be used as SET symbols, separated by 
Wh fet Teeth Wire tecti See Wa thzal ye venti lS who ae Se pe tese alot SE OMMAST: 2. nha en ye ers Me te A Bg ie | 
PoCLe Must not be present One or more variable symbols separated 
(RR deine Bea lees teeta A eS seats ain chal orate Mn oi POPS COMMAS Flac 8 alana Se oa leh eae 
LLTORG __| Any symbol or not present ae Must not be present F 
‘macro! _! Must not be present rae as Must not be present _ 
1 MEND! 1 A sequence symbol or not present | Must not be present ‘ 
Se fa anh cast Sas por te a ep a SE Be  -- - - - --- -- 
1MExIT! | A sequence symbol or not present | Must not be present 
ie A tie Aen Deeg IN Sided | Matt Jah a ahs SOD tine dees «ener Se 1 
| MNOTE1 A sequence symbol, a variable A severity code, followed by a comma, ; 
‘ ; Symbol or not present 1 followed by any combination of characters, 
1 L 1 enclosed in apostrophes 
eas rae ee rere Beas hat est hay Gao eee ee I Ge hel ta FOOT abe Rea ge et Ae nk een | Pe Pee? ae el 
| OPSYN* An ordinary symbol ; A machine instruction mnemonic code, an 
\ | ; extended mnemonic code, or an operation 
| I | code defined by a previous OPSYN instruc-! 
! ! ! tion | 
1 Poe Pee Beige FS ater ae ae Be tee We eg Sk A) Oe ae nt oR a gh oe ee pte IS ga 7 
1 | A machine or extended mnemonic 1 Blank i 
! | operation code | 1! 
Ro a ee ee Se ee oe Se es ee a 
| ORG | A sequence symbol or not present; A relocatable expression or not present , 
| PRINT is A sequence symbol or not present , One to three operands 
' PUNCH ' A sequence symbol or not present One to eighty characters enclosed in ; 
apostrophes 
Vast gh Ss NSS a al re oS co aE ye yee ae De ee ee Ne te lel ean Ode trl th Ul 
' REPRO ' A sequence symbol or not present ' Must not be present E 
1 SETA 1 A SETA symbol ! An arithmetic expression 
Sea te (a ae ee a ie ee a te crea io ie eer Se ea ee ee tte eg a ee at 
; SETB ; A SETB symbol 1 AO or a1, or logical expression 
' t | enclosed in parentheses 
bee om ee rp rtm rrr err rr rc Scented tice diene edie Te-plleniagdieatnerlien ar Tandientandaiatimataninetian “7 
; SETC Hs A SETC symbol , A type attribute, a character expression, 
1 i 1 a substring notation, or a concatenation | 
I 1 | of character expressions and substring 
j ' ' notations | 
Root r oe fr mr rr re cr rr ee PS Se Se Se eS See eae 4 
1 SPACE 1 A sequence symbol or not present | A decimal self-defining term or not I 
1 i | present y 
gare er eae Te er ay oe ee ee A ay TN eg ge Te eT ep ee ee get ener te oes Ry go cel 
1 START 1 Any symbol or not present 1 A self-defining term or not present 
[esr tage = SP can ae ah, eee ey ON Rie an Neh pe CO aay Oo Pee ne ah 2G arent CR TS a yaa Be Lee a ee q 
,; TITLES A special symbol (0 to 4 char- . One to 100 characters, enclosed in \ 
I ; acters), a sequence symbol, a 1 apostrophes ! 
1 1 variable symbol, or not I ! 
1 | present \ ' 
fa ie Tee Sie ee Pe oe Boa en gn oe NN NO eo ea er et Gea dea Pe ar heed 
1 USING 1 A sequence symbol or not present 1 An absolute or relocatable expression ' 
! 1 ' followed by 1 to 16 absolute expres- 
! | ' sions, separated by commas 
Sas Re aA ead aaeenirs Kase (ale aga eave cua oe as 
| WXTRN | A sequence symbol or not present | One or more relocatable symbols, sepa- ' 
: | | rated by commas ! 
ee eed Ae ie gn ody kT 8 ag eee ea ge en tae nag, ee ae ge 
1 lay only be used as part of a macro-definition. 
| *SEr symbols may be defined as subscripted SET symbols. \ 
| : : A ! 
| see Section 5 for the description of the name entry. ' 
* 
Assembler F only. 
t ! 
I t 
Be ee Sn Sh a Sa SAS ne ots OE ek i ee et et Bd ee ee ee Ser 4 


ASSEMBLER STATEMENTS 


Model Statements3 4 


{Prototype Statement? 
| 
| 
| 
| 
{ 
| 


| Macro-Instruction 
| Statement1 


{Assembler Language 
[Statement 4% 


| 
| 
| 
| 
| 
L 


JAn ardinary symbol, variable 
jsymbol, sequence variable 
|symbol, a combination of 
|variable symbols and other 
|characters that is equivalent 
|to a symbol, or not present 


|A symbolic parameter or 
Jnot present 


| 
| 
I 
| 
| 
+ 
JAn ordinary symbol, a 

|variable symbol, a sequence 


jsymbol, a combination of 
| variable symbols and other 


[characters that is equivalent|by commas) of the form 


[to a symbol,? or not present 


{An ordinary symbol, a var- 
[iable symbol, a sequence 
|symbol, a combination 

{of variable symbols and 
Jother characters that is 
Jequivalent to a symbol, 
Jor not present 


See aS oS Sa Se ee Soe eS 


a May only be used as part of a macro definition. 


2 Variable symbols appearing in a macro instruction are replaced py their 


before the macro instruction is processed. 


3 Variable 


REPRO, 


operand entries of 


symbols 
codes as listed in Section 5, except ACTR, COPY, END, ICTL, CSECT, 
and START. symbois may 


the following 


Variable 
instructions: 


{Any combination of char- | 
acters (including variable | 
symbols) | 
| 
| 
1 


| 
| 
| 
| 
| 
+ 
| Zero or more operands that | 
Jare symbolic parameters, sep-| 
Jarated by commas, followed by] 
|zero or more operands | 
| (separated by commas) of the] 


| form symbolic parameter, | 
jJequal sign, optional standard| 


| Zero or more positional | 
|operands separated by commas, | 
|followed by zero or more 

| keyword operands (separated 


Jkeyword, equal sign, value? 


whe ee 


{Any combination of characters | 
{ (including variable symbols) 


| 
| 
| 
| 
| 
| 


— 


mt ae Se ets ee 4 


values | 


may be used to generate assembler language mnemonic operation| 


DSECT, ISEQ, | 
not be used in the name and| 


COPY, END, ICTL, and ISEQ.| 


Variable symbols may not be used in the name entry of the ACTR instruction. | 


* No 


| 
| 
| 
| 
| 
| PRINT, 
I 
| 
| 
| performed. 


substitution 


variables in the line 


Appendix E: 


following a 


REPRO statement is{ 
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Appendix F: 


Summary of Constants 


APPENDIX F: SUMMARY OF CONSTANTS 
raid TTR 5 rare eer y eee Te Se Te 5 slr rica 7S SSS ToS 1 
| | l | | NUMBER | | | 
{ i { | LENGTH | | OF cON- | { J} TRUN- | 
| | IMPLIED | | MODI- | | STANTS | RANGE | RANGE | CATIONS | 
| | LENGTH | ALIGN- | FIER | SPECIFIED | PER | FOR EX- | FOR | PADDING | 
| TYPE | (BYTES) | MENT | RANGE | BY | OPERAND | PONENTS {| SCALE | SIDE | 
}------ }--------- ¢-------- f-------- $-------------- }--------- f--------- }----=--- }--------- { 
|} c | as | byte | -1 to | characters | one | l | right | 
| | needed | | 256 (1)| | | | l | 
p-----~ f--------- $-=----—- $-------- $-------------- f--------- --------- f-------- {--------- { 
| xX | as | byte | -1 to | hexadecimal | one | | | left | 
| { needed j| {| 256 (1)]| digits | | | | | 
}---~-- }--------- 4-—------ 4-------- f-~------------ }--------- }--------- 4-------- 4--------- { 
| B | as {| byte | -1 to | binary | one | | | left | 
| | needed | | 256 | digits | | { { | 
}------ }--------- f-------- f-—--=——- $o~--=--------- fo-------- fom-=----- $-------- $-----~--- 1 
| F { 4 {| word { -1 to | decimal | multi- | -85 to {| -187 to| left (4) } 
| | | | 8 | digits | ple | +75 ; +346) | | 
}----~- f--------- }-------- f-------- }-------------- 4--------- +---=----- 4-~-~---- 4--------- : 
{| 4 | 2 | half j -1 to | decimal { multi- | -85 to | -187 j left (4) | 
| | | word | 8 | digits | ple [| +75 | +346 | | 
[----~- $-------~~ $-------- fo-=----- +-------~------ $--------- }--------- fo--—-~-- }--------- { 
1 E | 4 | word | .1 to | decimal {| multi- | -85 to | Jxight (4) 
| | { | 8 | digits | ple } #75 { O-14 | | 
}------ }--------- }-------- 4-------- }---=---------- }--------- 4--------- 4-------- 4--------- { 
| D | 8 | double | .1 to | decimal | multi- | -85 to | J right (4)| 
| | { word { 8 | digits { ple {| +75 {| O-14 | | 
}-----— {-—------- $-------- $o-2----- $-==----------- $------—-— Senne +-—-—--- fo------== 4 
| L (3)| 16 | double | «1 to | decimal | muiti- { -85 to | 0-28 |vight (4) 
J | | word | 16 | digits | ple | +75 { | | 
f---—-- pg fon - n= n---- 4-----=-- 4--==---- 4------- 4---=----- 4 
| PB | as | byte | -1 to | decimal | multi- | l | left | 
| | needed | | 16 | digits | ple | | | | 
[ooo -= Tose eos : uae | SCRA IRAE | [eee | ease : ae tosses peste seseS 1 
| 2 | as | byte } .1 to | decimal | multi- {| | | left | 
| {| needed | | 16 | digits {| ple | { | | 
ears | nee tos s--S5 | aaa PosSoHe Sasso too -eoaS | acca aaa a tsesS55=5> 4 
| A | 4 | word | -1 to | any | multi- | | | left | 
| | | 1 4 (2) | expression | ple | | | | 
bSsac faa a acti $+-------- tenes aged ele tate {seas ae {= SSera> jee eae 1 
| (3) | 4 | word | 1-4 j symbol nam- | multi- | | | left | 
| | | | [eee eer | | | 
f------ --------- poweee—n- f-------- 4-9£_DSECT_____ $--------- }--------- }-------- $---=----- : 
| Vv { 4 | word | 3 or } relocatabie | multi- | | | left | 
| | | | 4 | symbol | ple | | | | 
}------ $--------- +-------- $-------- $------—------- f--------- fon------- 4-------- foa------- { 
1 s { 2 | half | 2 only | one absolute | multi- | { | | 
| | | word | | or relocatab-| ple { | | | 
| \ l | | le expression| I | l | 
| {= | | | or two absol-| | | | | 
| | | | | ute express- | | | | | 
| | | | | ions: | I | | | 
| | | | | exp (exp) | | | | 
}------ $--------- $-------- }-------- }-------------- }--------- }--------- foo-=---- }--------- { 
| x | 2 | half | -1 to | any | multi- | | | left { 
| | | word | 2 (2) | expression | ple | | | { 
a We See i ieee eer HC eee 2 eee perp ee ed 7 hae ene Merete ee ote Me SS 
;() In a DS assembler instruction C and X type constants may have length specification : 

to 65535. 
1 (2) Bit length specification permitted with absolute expressions only. Relocatable A- |! 
{ type constants, 3 or 4 bytes only; relocatable Y-type constants, 2 bytes only. { 
(3) Assembler F only. 

} 4) Errors will be flagged if significant bits are truncated or if the value specified 
L cannot be contained in the implied length of the constant. | 
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APPENDIX G: MACRO LANGUAGE SUMMARY 





The four charts in this appendix summarize the macro language described in Part II of 


this publication. 


Chart 1 indicates which macro language elements may be used in the name and operand 


mtries of each statement. 


Chart 2 is a summary of the expressions that may be used in macro-instruction 


statements. 


Chart 3 is a summary of the attributes that may be used in each expression. 


Chart 4 is a summary of the variable symbols that may be used in 


each expression. 





Variable Symbols 





Global SET Symbols 





Local SET Symbols 








Attributes 





System Variable Symbols 






































































































































































































































Symbolic Sequence 
Statement | Parameter &SYSNDX | &SYSECT | &SYSLIST Type Length Scaling Integer Count Number Symbol 
MACRO 
Prototype 
Statement 
GBLB 
GaBLC 
(cia =| 
iad ——e 
—t 
LCLC 
Model Name Name Name Name Name Name Name Nome Name 
Statement Operation | Operation | Operation] Operation | Operation | Operation | Operation | Operation | Operation|Operation 
Operand | Operand Operand | Operand | Operand { Operand Operand | Operand Operand |Operond 
SETA Name 
Operand? Operand Operand? Operand? Operand Operond 
SETB Name 5 
Operand® Operand® Operand Operand® Operand4 Operand Operand® 
SETC 7 8 Name 
Operand Operand” Operand’ | Operand | Operand Operand 
AE | 4 5 5 5 
Operand® | Operand® Operand® | Operand Operand® Operand® | Operand” | Operand Operand 
AGO 
ACTR Operand? Operand Operand Operand3 Operand? Operand | Operand Operand 
+- 
ANOP 
MEXIT HN | ie 
MNOTE Operand | Operand Operand |Operand | Operand Operand | Operand 
MEND 
Outer Name Name Name Name Name Name 
Macro Operand Operand | Operand | Operand { Operand Operand 
Inner Name Name Name Name Nome Name Name Name 
Macro Operand | Operand Operand | Operand | Operand | Operand Operand | Operand 
Assembler Name Name Name Name Name Nome 
Language Operation | Operation | Operation | Operation | Operation | Operation 
Statement Operand Operand | Operand | Operand | Operand Operand 
1. Variable symbols in macro-instructions are replaced by their values before processing. 
2. Only if value is self-defining term, 
3. Converted to arithmetic +1 or +0. 
4. Only in character relations. 
5. Only in arithmetic relations. 
6. Only in arithmetic or character relations. 
7. Converted to unsigned number. 
8. Converted to character | or 0. 
9%. Only if one to eight decimal digits. 


thart 1. Macro Language 





























Elements 


Appendix G 


Macro Language Summary 
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Chart 2. Conditional Assembly Expressions 

(SoS ee Ne re Se ae Te en rr eres Re ee eS 1 
| Expression | Arithmetic Expressions | Character Expressions | Logical Expressions | 
}--------~---- fun----------+----- === === f--~-----~-~-~=-------- fonnewn-- n= == += { 
| May | 1. Self-defining terms | 1. Any combination of J1. SETB symbols | 
| contain | 2. Length, scaling, | characters enclosed [2. Arithmetic re- | 
| | integer, count, and | in apostrophes | lations+4 | 
| | number attributes | 2. Any variable symbol |3. Character re- | 
| | 3. SETA and SETB symbols | enclosed in apostrophes | lations? | 
| | 4&. SETC symbols whose | | | 
| | value is 1-8 decimal | 3. A concatenation of | | 
| | digits | variable symbols and | | 
{ {| 5. Symbolic parameters | other characters { | 
| | if the corresponding | enclosed in apostrophes| | 
| | operand is a self- | | I 
| | defining term | 4. A request for a type | | 
| } 6. &SYSLIST(n) if the | attribute | | 
| | corresponding operand| { | 
| | is a self-defining { | | 
| | term | | | 
| {| 7. &SYSLIST(n,m) if the | | | 
( | corresponding operand| | | 
| | is a self-defining | | | 
| | term | l | 
{ | 8. &SYSNDX | | | 
}------------- fran nnn nnn nanan nnn fo na n-nonane enna }------------------- { 
| Operators { +.7.*, and / | concatenation, with a | AND, OR, and NOT | 
| are | parentheses permitted | period (.) | parentheses per- | 
| | | | mitted | 
}------------- f------------------------- }--------------------------- $a--—------s 3 === { 
| Range | ~294 to +234-1 { 0 through 255 characters |0 (false) or 

| of values | | {1 (true) | 
}------------- fu---------~-------------- }---------------------------}---- ~-------------- 
| May be | 1. SETA operands | 1. SETC operands? |1. SETB operands | 
{| used in | 2. Arithmetic relations | 2. Character relations? {2. AIF operands | 
| | 3. Subscripted SET { | 

| | symbols | | 
| } 4. &SYSLIST | | | 
| | 5. Substring notation { | I 
| | 6. Sublist notation | | | 
}------------- Laos cee eco ees ee So SoA eh SS ose ne Meo tA ae tt 
{ 7 An arithmetic relation consists of two arithmetic expressions related by the] 
| operators GT, LT, EQ, NE, GE, or LE. | 
{| 2 A character relation consists of two character expressions related by the operator| 
GT, LT, EQ, NE, GE, or LE. The type attribute notation and the substring notation] 
| may also be used in character relations. The maximum size of the character] 
| expressions that can be compared is 255 characters. If the two character| 
| expressions are of unequal size, then the smaller one will always compare less than| 
| the larger. | 
| 3 Maximum of eight characters will be assigned. | 
Vio fo ee ee ee ee ea ete ee ee J 
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Chart 3. Attributes 
jattribute ‘Notation 
| I 
p----------- + 
{Type | T° 
| | 

| { 

| | 

| ( 

| | 
[----------- + 

| Length { L* 
| l 

| | 

| ( 

| | 

| 1 
t----------- + 
[Scaling I s* 
| | 

| | 

{ I 

| | 

| | 
p-Seeseesee> + 

| Integer | I' 
| I 

| | 

| | 

| | 

| | 
t----------- + 
{Count | K‘ 
| | 

| | 

|. | 

{ | 

| i 

| | 
}--~--------- + 

| Number | N‘ 
| | 

| | 

| | 

[ eaee meee eee ene 4 

* NOTE: There are 


Section 9. 


+ 
{Symbols outside 


jor eo ap a HDs si ae nw i ie ee he a tee 


{May be used with: 


[Symbols outside 
{macro definitions; 
{symbolic parameters, 
{ESYSLIST(n), and 

| &SYSLIST(n,m) inside 
[macro definitions 


[Symbols outside 
{macro definitions; 
[symbolic parameters, 
| &SYSLIST(n), and 
{|&SYSLIST(n,m) inside 
{macro definitions 


{Symbols outside 
{macro definitions; 
{symbolic parameters, 
|&SYSLIST(n), and 
J&ESYSLIST(n,m) inside 
|macro definitions 


|macro- definitions; 
|symbolic parameters, 
|&SYSLIST(n), and 
{&SYSLIST(n,m) inside 
|macro definitions 


|Symbolic parameters 
| corresponding to 
[macro instruction 
joperands, &SYSLIST 
| (n), 
Jinside macro 
| definitions 


{Symbolic parameters, 
|§SYSLIST, and 

| &SYSLIST(n) inside 
|macro definitions 


and &SYSLIST (n,m) 


May be used only if 
Jtype attribute is: 


B 


y letter except 
»N,O,T, and U 


= 


definite restrictions in the use of these attributes. 


Appendix G: 


be 
. 


N 
. 


May be used in 


SETC operand 
fields 
Character 
relations 


Arithmetic 
expressions 


Arithmetic 
expressions 


Arithmetic 
expressions 


Arithmetic 
expressions 


+ YH Rt a st 


[Arithmetic 
Jexpressions 


Macro Language Summary 


t 
' 
' 
t 
' 
' 
| 
' 
' 
| 
! 
! 
' 
t 
| 
| 
' 
_ 


| 
| 
! 
! 
' 
! 
t 
' 
{ 
| 
| 
! 
| 
1 
! 
| 
{ 
-e 


Refer to text, 
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Chart 4. 


| variable 
[symbol 


{Symbolict 
| parameter 


&SYSNDX* 


&SYSECTL 


Variable Symbols 


oes 
|Initialized, 


| Jor set to: [| by: | | 
~~==--~------- }~-~-~--~-----}-+--~------------- $--~-----------}-------+-----------------4 
[Prototype | Corresponding | (Constant }1. Arithmetic expressions | 
jstatement [macro instruction [throughout | if operand is self- | 
| {operand | definition) | defining term { 
| | | |2. Character expressions | 
}--------~--~~- $----------------- fino n------ === $------------------------- { 
|LCLA or GBLA |0 |SETA Ji. Arithmetic expressions | 
Paneth on | | instruction |2. Character expressions | 
fon aaa onan nnn nnn n fone ne He fon-s---n----------------- { 

[| LCLB or GBLB [0 |SETB [|1. Arithmetic expressions | 
{instruction | | instruction {|2. Character expressions | 
i | | |3. Logical expressions | 
}----------------- fo------------- f------------------------- { 

{LCLC or GBLC |Null character | SETC J1. Arithmetic expressions} 
Jinstruction |value {| instruction | if value is self- | 
| | | | defining term { 
| | | |2. Character expressions | 
}------------- }--------------~-- $-—---~---~---- }--~---------------------- 
{The assembler|Macro instruction| (Constant |i. Arithmetic expressions | 
| | index | throughout |2. Character expressions | 
| | |definition; | | 
{ \ junique for | | 
| | Jeach macro- | | 
| | Jinstruction) | | 
foe wenn nnn nn fone enc nnn nen fon nnn toennnncroo == === { 
|The assembler|Control section {| (Constant [Character expressions | 
| Jin which macro {throughout | | 
| [instruction | definition; I | 
| Jappears [set by CSECT, | | 
| | |DSECT, and | | 
| | |START) | | 
}$------------~ $---------------~ t-------=------ foon---2=7~--------------- 
|The assembler |Not applicable |Not applicable|N‘'&SYSLIST in arithmetic | 
| | | expressions | 
Se eRe eal fetes teens Sats Swan ersanechnaiany fromm nner nnn nnn naan enna ne : 
|The assembler|Corresponding | (Constant {1. Arithmetic expressions | 


| &SYSLIST (n)+ 


| SSYSLIST (n,m) 4| 


Jmacro instruction | throughout 


if operand is self- | 


| 
| | | operand {definit ion) | defining term l 
| | | | |2. Character expressions | 
}-------------- 4------------- Sone fone manne en f------------ --+=--------- : 
{ + May only be used in macro definitions. | 
{ooo Se ee Ce ee oe eee ee ee eee ee oe eh oe Se ee a ee ear ee 4 
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APPENDIX H: SAMPLE PROGRAM 


Given: 

1. A TABLE with 15 entries, each 16 bytes long, having the following format: 
Pyro ee eso eee ee Tete ee eA pS ree es 1 
| NUMBER of items | SWITCHes | ADDRESS | NAME | 
(ik Se Be aes ee as ee fe ot Se SSE ee a 

3 bytes 1 byte 4 bytes 8 bytes 

2. A LIST of items, each 16 bytes long, having the following format: 
Po Vices a aie er Te Tee ean ee ee ae To, Cee a ee 1 
| NAME | SWITCHes | NUMBER of items | ADDRESS | 
Passes ee De ie WG ae de sh ee J 

8 bytes 1 byte 3 bytes 4 bytes 


Find: Any of the items in the LIST which occur in the TABLE and put the SWITCHes, 


NUMBER of items, and ADDRESS from that LIST entry into the corresponding TABLE 
entry. If the LIST item does not occur in the TABLE, turn on the first bit in 
the SWITCHes byte of the LIST entry. 


The TABLE entries have been sorted by their NAME. 


TITLE SAMPLOOL 
PRINT DATA SAMPLOO2 

* SAMPLOO3 
* THIS IS THE MACRO DEFINITION SAMPLOO4 
* SAMPLOOS 
MACRO SAMPL O06 

MOVE &TO,&FROM SAMPLOOT7 

-* SAMPLOOB 
* DEFINE SETC SYMBOL SAMPLOO9 
.* SAMPLOLO 
LCLC &TYPE SAMPLO11 

* SAMPLO12 
* CHECK NUMBER OF OPERANOS SAMPLO1L3 
* SAMPLOL4 
AIF — (N*ESYSLIST NE 2). ERRORL SAMPLOL5 

* SAMPLO16 
* CHECK TYPE ATTRIBUTES GF OPERANDS SAMPLO1T? 
.* SAMPLO18 
AIF (T"&TO NE T'&FROM).ERROR2 SAMPLOL9 

AIF (T*&TO EQ 'C* OR THETG EQ 'Gt OR T'ETO EQ "K').TYPECGK SAMPLOZ0 

AIF (T*&TO EQ 'D* OR T*ETO EQ 'E* OR T'ETO EQ "H*).TYPEDEH  SAMPLO21 

AIF (T*&TO EQ "F").MOVE SAMPLOZ2 

AGO -ERROR3 SAMPLO23 

-TYPEDEH ANOP SAMPLOZ24 
# SAMPLO25 
* ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL SAMPLO26 
oe SAMPLO27 
&TYPE -SETC -T*eTO SAMPLO28 
«MOVE = ANOP SAMPLO29 
+ NEXT TwO STATEMENTS GENERATED FOR MOVE MACRO SAMPLO30 
LETYPE  2,6FROM SAMPLO31 

ST&TYPE 2,610 SAMPLO32 

MEXIT SAMPLO33 

* SAMPLO34 
* CHECK LENGTH ATTRIBUTES OF OPERANDS SAMPLO35 
* SAMPLO36 
«TYPECGK AIF (L'&TU NE L'EFROM OR L*&TO GT 256).ERRORG SAMPLO37 
x NEXT STATEMENT GENERATED FOR MOVE MACRO SAMPLO38 
MVC &TQyGFROM SAMPL 039 

MEXIT SAMPL040 

* SAMPLO41 
“* ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS SAMPLO42 
* SAMPLO43 
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-ERRORL 
«ERROR2Z 
«ERROR 
»ERROR4 
* 
* 
x 


SAMPLR 
BeGIN 


MORE 


LISTLOOP 


EXIT 


* 
NOTRIGHT 


NOTTHERE 
SAVE13 
SWITCH 
NONE 

* 


* 
* 


SEARCH 


Looe 


HIGHER 
NOTF OUND 
* 


«x 
a 


TABLAREA 
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MNOTE 
MEXIT 
MNOTE 
MEXIT 
MNOTE 
MEXIT 
MNOTE 
MEND 


1,'I1MPROPER NUMBER OF CPERANUS, NO STATEMENTS GENERATED* 


1, *QPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED!' 


lytIMPRGPER OPERAND TYFES, NG STATEMENTS GENERATED® 


1, "IMPROPER QPERAND LENGTHS, NO STATEMENTS GENERATED? 


MAIN ROUTINE 


CSECT 
SAVE 
BALR 
USING 
ST 
LM 
USING 
BAL 
™ 
BO 
USING 
MOVE 
MOVE 
MGVE 
pXLE 
cLe 
BNE 
CLO 
BNE 
WTO 
L 


(14.12),,* 

R1lz+0 ESTABLISH ADDKESSAbILITY OF PROGRAM 
*,R12 AND TELE THE ASSeMBLER WHAT BASE TO USE 
13,SAVEL3 

R5SsKTyZACLISTAREAs16y,LISTEND) LOAU LIST AREA PARAMETERS 
LISTRS REGISTER 5 POINTS TQ THE LIST 

R14sSEARCH FIND LIST ENTRY IN TABLE 

SwIlTCHyNONE CHECK TO SEE IF NAME WAS FOUND 

NOTTHERE BRANCH IF NOT 

TABLE eR1 REGISTER 1 NOW POINTS TO TABLE ENTRY 
TSwITCHel SWITCH MOVE FUNCTIONS 

TNUMB&ERsL NUMBER FROM LIST ENTRY 
TADDRESSyLADORESS TO TABLE ENTRY 
k5—eR6- MORE LOOP THROUGH THE LIST 
TESTTABL(240),TABLAREA 

NOTRIGHT 

TESTLIST(96) ,LISTAREA 

NOTRIGHT 

“ASSEMBLER SAMPLE PROGRAM SUCCESSFUL' 

R13ySAVE13 


RETURN (14912) ,RC=0 


wTO 
8 
ol 
B 
oc 
oc 
EQU 


"ASSEMBLER SAMPLE PROGEAM UNSUCCESSFUL * 


EXIT 


LSwWITCH,NONE TURN ON SwIiTCH IN LIST ENTRY 
LISTLOOP GO BACK AND LOOP 


Ftof 
x*oot 
x*a0f 


GINARY SEARCH ROUTINE 


NI 
LM 
LA 
SRL 
cLe 
BH 
BCR 
SR 


act 
8 
AR 
BCT 
ol 
BR 


THIS 


OS 
oc 
Dc 
oC 
DC 


SwWiTCH,255-NONE TURN OFF NOT FOUND SWITCH 


R1yR3—=F'128+40128° 
Rls TABLAKEA~16(R1) 
R351 

LNAME, TNAME 

HIGHER 

6,R14 

k1,R3 


k2,L00P 
NOTFGUND 
K1L,R3 
K2,LOGP 
SWITCH ,»NONE 
R14 


TS THE TABLE 


oD 
XLB*O',CLB*ALPHAS 
XLE*O'»sCLE*BETA® 
XL6'0',CLB‘OELTA! 
XLB'O*,CLB*EPSILON® 
XLB°O",CLATETAt 
XLB'0',CLB*GAMMAt 
XLB'O',CLE*ICTAS 
XL8O",CLB*KAPPAT 
XL6*0t,CLE*LAMBDA® 
XLB‘O*,CLB*MUt 
XL8'O",CLE*NUS 
XL8*0',CLE*OMICRON 
XL8'0",CLB*PHI® 
XL8'O",CLE*SIGMAt 
XL8*O"',CLE"ZETA® 


LOAD TABLE PARAMETERS 

GET ADDRESS GF MIDDLE ENTRY 

OLVIDE INCREMENT BY 2 

COMPARE LIST ENTRY WITH TABLE ENTRY 

BRANCH IF SHOULD BE HIGHER IN TABLE 

EXIT IF FOUND 

OTHERWISE IT IS LOWER IN THE TABLE 
SG SUBTRACT INCREMENT 

LOOP 4 TIMES 

ARGUMENT IS NOT IN THE TABLE 

ADD INCREMENT 

LOOP 4 TIMES 

TURN ON NOT FOUND SWITCH 

EXIT 


SAMPLO044 
SAMPL045 
SAMPLO46 
SAMPLO47 
SAMPLO048 
SAMPL049 
SAMPLO50 
SAMPLO51 
SAMPLOS5S2 
SAMPLO53 
SAMPLO54 
SAMPLO55 
SAMPLO56 
SAMPLO57 
SAMPLO58 
SAMPLO59 
SAMPLO60 
SAMPLO61 
SAMPLO62 
SAMPLO63 
SAMPLG64 
SAMPLO65 
SAMPLO66 
SAMPLO67 
SAMPLO68 
SAMPL 069 
SAMPLO70O 
SAMPLO71L 
SAMPLO72 
SAMPLOT3 
SAMPLOT4 
SAMPLOT5 
SAMPLOT6 
SAMPLO77 
SAMPLOT8 
SAMPLOT9 
SAMPLO8O 
SAMPLO81 
SAMPL 082 
SAMPLO83 
SAMPLO84 
SAMPLO85 
SAMPLO86 
SAMPLOS7 
SAMPLO&B 
SAMPLO89 
SAMPLO90 
SAMPLO91 
SAMPLOU92 
SAMPLO93 
SAMPLO94 


XSAMPLOG5 


SAMPLOS6 
SAMPLO9T 
SAMPLO98 
SAMPLO99 
SAMPL100 
SAMPL101 
SAMPL102 
SAMPL103 
SAMPL104 
SAMPL105 
SAMPLLO6 
SAMPL1O7 
SAMPL108 
SAMPL1O9 
SAMPLL1O 
SAMPLILL 
SAMPLIL2 
SAMPL113 
SAMPL114 
SAMPL115 
SAMPL1L6 
SAMPL117 
SAMPL118 
SAMPL119 
SAMPL120 
SAMPLI21 
SAMFL 122 


* 
* 


LISTAREA 


LISTEND 
* 
* 
* 


TESTTABL 


* 
x 
* 
TESTLIST 


* 

* 

* 

RO 

RL 

R2 

R3 

R5 

R6 

RT 

R12 

R13 

R14 

RLS 

* 

x 

* 

LIST 
LNAME 
LSWITCH 
LNUMBER 
LADDRESS 
* 

* 

* 

TABLE 
TNUMBER 
TSWITCH 
TADDRESS 
TNAME 


THIS IS THE LIST 


oc CLE*LAMBDA',X*OA'T FL3"29' AC BEGIN) 
oc CLB*ZETA*sX*05%yFL3'5' A(LOOP) 

oc CLE*THETA® X9024 ,FL3'45% yA( BEGIN) 
oc CLE*TAUTs X*00",FL3*Ot ACL) 

oc CLE*LIST's X*LF'sFL3'465",A(0) 

DC CLB*ALPHA' »X*00's,FL341*,A(123) 


THIS IS THE CONTROL TABLE 


oS oD 

oc FL3*1L*,X*00%,AC1L230,CLB8*ALPHA® 
oc XL8*0';CLBE'BETAS 

oC XL8*0%,CLE*DELTA® 

oC XL8°O'sCLO* EPSILON! 

oC XL6°0",CLETETA® 

bc XL8°0'yCLE'GAMMAt 

oc XL840',CLE'IOTA® 

oc XL8*O',CLE'KAPPAt 

oc FL3°29*%,X*O0A" sAC BEGIN) »CL8*LAMBDA' 
oc XL8*0%,CLB8*MUt 

oc XL8*O"',CL8'NUS 

oc XL8°O",CL8*CMICRON! 

oe XL8"O',CLE*PHI' 

oc XL840"%,CLE'SIGMA® 

oc FL3"5"sX*O5",A(LOOP),CLE'ZETA® 


THIS IS THE CONTROL LIST 


oc CLEB"*LAMBDA',X*OA'yFL3'29" ,AC BEGIN) 
oc CLBYZETA sX#05%yFL3"5' sA( LOOP) 

oC CLE" THETA® »X*82" FL 3°45! ,A( BEGIN} 
OC CLE*TAUS,X*B0"FLZ*O' ACL) 

oc CLEILIST's X*9F*,FL3*465" ,A(0) 

oc CLE*AL PHA", X"00% FLL" ,AC1L239 


THESE ARE THE SYMBOLIC REGISTERS 


EQU 0 
EQU 1 
EQU 2 
EQU 3 
EQU 5 
EQU 6 
EQU 7 
EQU 12 
cQU 13 
EQU 14 
€Qu 15 


THIS IS THE FORMAT DEFINITION OF LEST ENTRYS 


OSECT 

DS CL8 
OS c 
OS FL3 
os F 


THIS IS THE FORMAT DEFINITION OF TABLE ENTRYS 


OSECT 

DS Fe3 
oS Cc 
cs F 
oS CL8 


END BEGIN 


SAMPL123 
SAMPL124 
SAMPL125 
SAMPL126 
SAMPL1L27 
SAMPL1Z8 
SAMPL129 
SAMPL130 
SAMPL131 
SAMPL132 
SAMPL133 
SAMPL134 
SAMPL135 
SAMPL 136 
SAMPL137 
SAMPL138 
SAMPL139 
SAMPL140 
SAMPL141 
SAMPL142 
SAMPL 143 
SAMPL144 
SAMPL145 
SAMPL146 
SAMPL147 
SAMPL148 
SAMPL149 
SAMPL150 
SAMPLI51 
SAMPL152 
SAMPL153 
SAMPL154 
SAMPL155 
SAMPL156 
SAMPL157 
SAMPL158 
SAMPL159 
SAMPL160 
SAMPL161 
SAMPL162 
SAMPL163 
SAMPL164 
SAMPL165 
SAMPL166 
SAMPLLE7 
SAMPL168 
SAMPL169 
SAMPL170 
SAMPLI71 
SAMPL172 
SAMPL173 
SAMPL174 
SAMPL175 
SAMPL176 
SAMPLLT77 
SAMPL178 
SAMPL179 
SAMPL180 
SAMPL181 
SAMPL182 
SAMPL183 
SAMPLL84 
SAMPL185 
SAMPL186 
SAMPL187 
SAMPL188 
SAMPL189 
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APPENDIX I: 


ASSEMBLER LANGUAGES-- FEATURES COMPARISON CHART 


Features not shown below are common to all assemblers. In the chart: 
Dash = 
x 7 


Not allowed. 











Basic 








No. of Continuation Cards/Statement 
(exclusive of macro-instructions) 







Input Character Code 










ELEMENTS: 
Character self-defining terms 
Binary self-defining terms 
Length attribute reference 
Literals 
Extended mnemonics 
Maximum Location Counter value 
Multiple Control Sections per assembly 
EXPRESSIONS: 


Operators 


NR 
nN 
pb 

_ 


nN nN 


Number of terms 
Levels of parentheses 


Complex relocatabil ity 





ASSEMBLER INSTRUCTIONS: 


DC and DS 


Expressions allowed as modifiers 











Multiple operands 


Multiple constants in an operand 


Scale modifier 
Exponent Modifier 


DC types 


DC duplication factor 


V Assembler F only 


Appendix I: 


Programming 7090/7094 noe ax 1 
Ss t ape, 
Feature Support/360: Package BOS 8K Disk venti oe 
Basic Assembler Assemblers amit Assembler 
Assembler 


EBCDIC 


1 Char. only 


+=* 
3 


Bit length specifications == | 


As defined in Operating System/360 Assembler Language Manual, 































p 


BCD & EBCDIC EBCDIC EBCDIC 


EBCDIC 








al 
a 
aa ee al 
+oH/ rene eee +—/ 
3 16 16 
1 
x 


Address 
Consts. 











Except L 
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Basic 
: 7090/7094 
Programming Support BPS 8K Tape, | DOS/TOS | O5/360 
Feature Support/360: Packa BOS 8K Disk | Assembler Assembler 
a ge 
Basic Assemblers 
Assembler 
Assembler 
DC duplication fector of zero ae eel Except S 
DC length modifier Except x x 
H, E—, D 
eas eo ~~ TOnly € Only € 
DS t yy, Y 
DS length modi fer Only C Only C 
DS maximum length modifier 256 256 
DS constant subfield permitted aS al 
CSECT eae eae 
z = oe es 
LTORG ‘| -- -- 
ae 
i + 
ICTL ‘| 1 operand 1 operand 
(Tor 25 
only) 
USING 2 operands | 2-17 operands 
{operand 1 | (operand 1 
relocatable | relocatable 
| only) only) 
DROP 1 operand 
only 
ccw operand 2 
(relocatable 
only) 
ORG no blank no blank 
operand operand 
ENTRY 1 operand 1 operand 1 operand 
only only only 
ae st a ae a minder 
EXTRN 1 operand 1 operand 1 operand 
| only (max 14) | only only 
WXTRN ited are) 
CNOP + 2 decimal 2 decimal 2 decimal 
digits digits digits 
PUNCH =e ae 
REPRO -- aoe 
Macro Instructions -- os 
OPSYN 2 tres 
EQU x x 
eee = Asks = 








' Assembler F only 


2 DOS Assembler 14XD only 
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In the chart: 
Not allowed. : 
As defined in Operating System/360 Assembler Language Manual. 


Features not shown below are common to all assemblers. 
Dash = 
x = 
Basic 
Programming 
Support/360: 
Basic 
Assembler 


7090/7094 
Support 
Package 
Assembler 


BPS 8K Tape, 
BOS 8K Disk 


Assemblers 


Feature 


No. of Continuation Cards/Statement 
(exclusive of macro-instructions) 


Input Character Code 

ELEMENTS: 
Maximum Characters per symbol 
Character self-defining terms 
Binary self-defining terms 
Length attribute reference 
Literals 

Extended mnemonics 


Maximum Location Counter value 





Multiple Control Sections per assembly 


OS/360 
Assembler 


EBCDIC 


DOS/TOS 
Assembler 


EBCDIC 


x 
x 
x 


x 


x 
224.) 


x 





Number of terms 





Levels of parentheses 
Complex relocatability 


ASSEMBLER INSTRUCTIONS: 





DC and DS 


Expressions allowed as modifiers 


+ at / 
16 
5 
x 
Xx 





Multiple operands 





Multiple constants in an operand 
Address 


Consts. 


Bit length specifications 


Scale modifier 





Exponent Modifier 


DC types 


DC duplication factor 


Vassembler F only 


2DO$ 14K D Assembler only 





x 


ied NO 


BS 


x 





16 
5 
x 
x 
x 
x 
x 


»CONTF 


=CONTH 


2EL 
aE2 


2€3 


AIF 
STM 
MEXIT 
AIF 
STM 
MEXIT 
THBERMAC £8,360 REG PARAM MISSING 
MEXIT 
THBERMAC 37,350,ECODE 
MEXIT 


{N*GREG NE 2).CONTH 


14sGREG(2)512013) SAVE REGISTERS 


{NtEREG NE L).E3 
14,GREGEL) 12013) SAVE REGISTERS 


INVALIO CODE SPECIFIED 


THBERMAC 364360+6REG INVALID REGS. SPECIFIED 


MEND 


€NO OF DATA FOR SOS OR MEMBER 


FOGHORN 
FOGHORN 


SAVMACRO 
SAVMACRO 


SAVE 
oS 
STM 


SAVE 
bs 


SAVE 


STM 


SAMPLE SAVE MACRO INSTRUCTIONS 


(14,12) 
OH 
14912022013) SAVE REGISTERS 


Saeveseneet 


(REGIS, REGI21,T 
oH 
12e##8 [HBOO2 INVALID FIRST OPERAND SPECIFIED-(REGI4«R 


seeensaneos 


(14512) ,7Te® 

14(0¢153 BRANCH AROUND ID 
AL1(8) 

CLE*SAVMACRO® LDENTIFIER 


14912912023) SAVE REGISTERS 


MEMBER NAME NOTE 


ENAME 


ENAKE 


o ERR 


MEMBER NAME 


ENAME 


&NAME 


ERR] 


aERR2 


MEMBER NAME 


ENAME 


ENAME 


2EL 


MACRO 
NOTE 
AIF 


eDCBK 
(*8OCK* EQ **).ERR 


THBINNRA £NDCB 


L 
BALR 
MEXIT 


155 84(0-1) LOAD VOTE RTN ADDRESS 
14,15 LINK TO NOTE ROUTINE 


IHBERMAC 6 


MEND 


MACRO 
POINT 
AIF 
AIF 


POINT 


&DCB, ELOC 
('EDCB" EQ *') ERRL 
(fELGC* EO #8), ERR2 


THBINNRA €0C8,6L0C 


i 
BAL 
MEXTT 


15584(0,1) L040 PIINT RTN ADDRESS 
1424(15,9) LINK TO POINT ROUTINE 


IHBERMAC 6 


MEXIT 


ITHBERMAC 3 


MEND 


MACRO 
CHECK 
ATF 


CHECK 


&0ECH 
CTEDECH* EQ '*).E1 


THBINNRA &DECBR 


L 

L 
BALR 
MEXIT 


14,8(0,1) PICK UP DCB ANDRESS 
1595200514) LOAD CHECK RUUT. ATOR. 
14515 LINK FO CHECK ROUTINE 


THBERMAC 07,018 


MEND 


91460000 
01480000 
01500000 
01520000 
01540000 
01560000 
61580000 
01600000 
01620000 
01640000 
01660900 
01680000 


00020000 
90040000 
909060000 
90080000 
00100000 
90120000 
00140009 
90160000 
90140000 


00020006 
90040000 
00060000 
00080000 
00100090 
60120000 
90140000 
90160090 
90180000 
00200090 
90220900 
00240000 


90020000 
90040000 
90060000 
90080000 
00 LOOGOU 
00120009 
00140009 
90160000 
00186C00 
00200000 


INDEX 


Indexes to systems reference library manuals are consolidated in the publication IBM System/360 Operating System Systems Reference 
Library Master Index, Order No. GC28-6644, For additional information about any subject listed below, refer to other publications lis ted 


for the same subject in the Master Index. 


&SYS,restrictions on use 67,81,95 


&SYSECT (see current control section name) 
&SYSLIST (see macro instruction operand) 


&SYSNDX (see macro instruction index) 
7090/7094 Support Package Assembler 


Absolute expressions 17,29 
Absolute terms ane) 

ACTR instruction 89 

Address constants 47-49 


A-type 47 
Complex relocatable expressions 
Literals not allowed 15 
Q-type 48 
S-type 48 
V-type 48 
Y-type 47 
Address specification 30 
Addressing 
Dummy sections 24 
Explicit 19 
External control sections 28 
Implied 19 
Relative 21 
AGO instruction 89 
AIF instruction 88 
Alignment, boundary 
CNOP instruction for 56 
Machine instruction 29 
Ampersands in 
Character expressions 83 
Macro instruction operands 71 
MNOTE instruction 94 
Symbolic parameters 67 
Variable symbols 62,140 
ANOP instruction 90 
Apostrophes 
Character expressions 84 
Macro instruction operands 71 
MNOTE instruction 94 
Arithmetic expressions 
Arithmetic relations 86 
Evaluation procedure 82 
Invalid examples 82 
Operand sublists 72 
Operators allowed 81 
Parenthesized terms 
evaluation 82 
examples 82 
SETA instruction 81 
SETB instruction 86 
Substring notation 84 
Terms allowed 81 
Valid examples 81 
Arithmetic relations 86 
Arithmetic variable 98 
Assembler instructions 
Statement 35,133 
Table 131 
Assembler language 
Basic Programming Support 
Comparison chart 145 
Macro language, relation to 61 
Statement format 8,9 
Structure 10,11 


9,145 


3,145 


47 





Assembler program 

Basic functions 4 

Output 22 
Assembly, terminating ar. 58 
Assembly no operation (see ANOP 


instruction) 
Attributes 
How referred to 77 
Inner macro instruction operands 76 


Notations 76 

Operand sublists 76 

Outer macro instruction operands 76 
Summary chart 139 

Symbols 76 

Types 76 

Use 76 

(see also specific attributes) 


Basic Programming Support Assembler 
Base registers 
Address calculation 
DROP instructions 20 
Loading 20 
USING instructions 19 
Begin column 8,53,54 
Binary constant 43 
Binary self-defining term 13 
Binary variable 98 
Blanks 
Logical expressions 86 
Macro instruction operands 71 
ccW instruction 50 
Channel command word, defining 51 
Character codes 107 
Character constant 42 
Character expressions 
Ampersands 84 
Apostrophes 84 
Character relations 86 
Examples 84 
Periods 84 
SETB instructions 86 
SETC instructions 83 
Character relations 86 
Character self-defining term 13 
Character set 15,107 
Character variable 98 
CNOP instruction 56 
Coding form 7 
Columns (begin, continue, end) 
COM instruction 26 
Commas, macro instruction operands 72 
Comment Entry 9 
Comment statements 
Example 69 
Model statements 69 
Not generated 69 
Comparison chart 145 
Compatibility 
Assembler language 3 
Macro definitions 104 
Complex relocatable expressions 47 
Concatenation 
Character expressions 
Defined 68 


3,145 


4,28,30 


8,53,54 


83,85 


Index 151 


AIF instructions 88 


Arithmetic relations 86 
Blanks 86 
Character relations 86 


Evaluation 87 
Invalid Examples 87 
Logical operators 86 
Parenthesized terms 
Evaluation 87 
Examples 87 
Relation operators 86 
SETB instructions 86 
Terms allowed 86 
Valid examples 87 
LTORG instruction 55 
Machine-instruction examples and format 


RR 29,31 

RS 29,32 

RX 29,32 

SI 29,32 

SS 29,32 

Summary table 119 
Machine-instruction mnemonic codes 31 


Alphabetical listing 122 
By duration code 129 
Machine instructions 29 
Alignment and checking 29 
Literals, limits on 14 
Mnemonic operation codes 31 
Operand fields and subfields 29 
Symbolic operands 31 
MACRO 
Format 65 
Use 65 
Macro library defined 61 
Macro definition 
Compatibility 104 
Defined 61 
Error flagging 58 
Example 67 
Header 65 
How to prepare 65 
Keyword (see Keyword macro definition) 
Mixed-mode (see Mixed-mode 
macro Gefinition) 
Placement in source program 65 
Trailer 65 
Use 61 
Macro definition exit (see MEXIT 
instruction) 
Macro definition header statement (see 
MACRO) 
Macro definition trailer statement (see 
MEND) 
Macro instruction 
Defined 61 
Example 67 
Format 71 
How to write 71 
Levels 74 
Mnemonic operation code 71 
Name field 71 
Omitted operands 72 
Examples 72 
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Operand field 71 
Operand sublists 72 
Operands 
Ampersands 72 
Apostrophes 71 
Blanks 72 
Commas 72 
Equal signs 71 
Parentheses 71 
Operation field 71 
Statement format 72 
Types 61 
Macro instruction index (&SYSNDX) 
Examples 99 
Use 98 
Macro instruction operand (&SYSLIST) 
Attributes 100 
Use 100 
(see also symbolic parameters) 
Macro instruction prototype statement (see 
prototype statement) 
Macro instruction statement (see macro 
instruction) 
Macro language 
Comparison chart 147 
Extended features 93 
Relation to assembler language 61 
Summary 91,137-140 


MEND 
Format 65 
MEXIT instruction, contrasted 93 
Use 65 
MEXIT instruction 
Example 93 
Format 93 
MEND, contrasted 93 
Mixed-mode macro definitions 
Positional macro definitions, 
contrasted 103 
Use 103 
Mixed-mode macro instruction 103 
Mixed-mode prototype statement 103 
Mnemonic operation codes 29,31 
Extended 32 
Machine instruction 31 
Macro instruction 65 
MNOTE instruction 
Ampersands 94 
Apostrophes 94 
Error message 94 
Examples 94 
Format 93 
Severity code 94 
Model statements 
Comments field 67 
Defined 66 
Name field 66 
Operand field 67 
Operation field 66 


N' (see Number attribute) 
Name entry 8 


Number attribute 
Defined 79 
Examples 79 


Operand sublist 
Alternate statement format 72 
Defined 72 
Examples 73 


Operands 
Entries 8 
Fields 29 
Subfields 29,30 
Symbolic 27,29,30 


Operating system 5 
Operation field 29 
OPSYN instruction 

ORG instruction 55 
Outer macro instruction defined 73 


35,36 


Paired apostrophes 71 
Paired parentheses 71 
Parentheses 
Arithmetic expressions 82 
Logical expressions 87 
Macro instruction operands 71 
Operand fields and subfields 29 
Paired ree 
Period 
Character expressions 84 
Comments statements 69 
Concatenation 68 
Sequence symbols 80 
Positional macro definition (see macro 
definition) 
Positional macro instruction (see macro 
definition and macro instruction) 
Previously defined symbols 12 
PRINT instruction 52 
Program control instructions 53 
Program listings: 5 
Program sectioning and linking 22 
Prototype statement 
Examples 66 
Format 65 
Keyword (see keyword prototype 
statement) 
Mixed-mode (see mixed-mode prototype 
statement) 
Name field 65 
Operand field 65 
Operation field 65 
Statement format 
Alternate 66 
Normal 66 
Symbolic parameters 65 
Pseudo Register (see DXD instruction) 
PUNCH instruction 54 


Quotation marks (see Apostrophes) 
Quoted string 71 


Relational operators 86 
Relative addressing 21 
Relocatability 4,10,11 

Attributes 17 

Program, general register zero 20 
Relocatable expressions 17,29 

In USING instructions 20 


Relocatable terms 


10,11 
Pairing of 17 
In relocatable expressions 17 


REPRO instruction 55 


RR 


RS 


RX 


Ss! 


machine instruction 

Format Sd ,419 

Length attribute 29 
machine instruction 
Address specification 30 
Format 32,119 

Length attribute 29 
machine instruction 
Address specification 30 
Format 32,119 

Length attribute 29 


{see scaling attribute) 


Sample program 141 
Scale modifier 


Fixed-point constants 43 
Floating-point constants 45 


Scaling attribute 


Decimal fields 78 
Defined 78 

Examples 78 

Fixed-point fields 78 
Floating-point fields 78 
Restrictions on use 78 
Symbols 78 


Self-defining terms 12 

(see also specific terms) 
Sequence checking 54 
Sequence symbols 


AGO instruction 89 
AIF instruction 88 
ANOP instruction 90 
How to write 80 
Invalid examples 80 
Macro instruction 80 
Valid examples 80 


Set symbols 


Assigning values 75 

Defining 75 

Symbolic parameters, contrasted 75 

Use 75 

(see also local SET symbols, global SET 
symbols, and subscripted SET symbols) 


SET variable 94 
SETA instruction 


Examples 81-83 

Format 81 

Operand field 
Evaluation procedure 
Operators allowed 81 
Parenthesized terms 82 
Terms allowed 81 
Valid examples 82 

Operand sublist 82 
Examples 82 


81,82 


SETA symbol 


Arithmetic relations 82 
Assigning values to 82 
Defining 75,82 

Use 82 


SETB instruction 


Examples 86 
Format 86 
Logical expressions 86 
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A macro definition consists of: 


1. A macro definition header statement. 


2. A macro instruction prototype state-~ 
ment. 

3. Zero or more model statements, COPY 
statenents, MEXIT, MNOTE, or 


conditional assembly instructions. 
4. A macro definition trailer statement. 


Except for MEXIT, MNOTE, and conditional 
assembly instructions, this section of the 
publication describes all of the statements 
that may be used to prepare macro 
definitions. Conditional assembly 
instructions are described in Section 9%. 
MEXIT and MNOTE instructions are described 
in Section 10. 


Macro definitions appearing in a source 
oregram must appear before all PUNCH and 
REPRO statements and all statements which 
pertain to the first control section. 
Specifically, only the listing control 
instructions (EJECT, PRINT, SPACE, and 
TITLE), OPSYN, ICTL, and ISEQ instructions, 
and comments statements can occur before 
the macro definitions. All but the ICTL 
and OPSYN instruction can appear between 
macro definitions if there is more than 
one definition in the source program. 
Conditional assembly, substitution, and 
sequence symbols cannot be used in front of 
or between macro definitions. 


A macro -definition cannot appear within 
a macro definition and the maximum number 
of continuation cards for a macro definition 
statement is two. 


MACRO -- MACRO DEFINITION HEADER 

The macro definition header statement 
indicates the beginning of a macro 
definition. It must be the first statement 


in every macro definition. 
this statement is: 


The format of 


ee TS yn eae Fin ge ee nt ae ee eee ee 1 
| Name jOperation |}Operand | 
See coe ee eee Sa ee ere { 
|Blank |MACRO | Blank | 
be Seok Meee ee ee Poa eee Pee J 
MEND -- MACRO DEFINITION TRAILER 


The macro definition trailer statement 
indicates the end of a macro definition. 
It can appear only once within a macro 


SECTION 7: 


HOW TOC PREPARE MACRO DEFINITIONS 


definition and must be the last statement 
in every macro definition. The format of 
this statement is: 


Gore EE ee ee a ee Oe i ep ee ‘1 
{Name {Operaticn [{Operand | 
eae vores oe -----------=--------- : 
se- | MEND | 8lank | 
quence | | | 
pommbors | | 
y OF | | | 
blank 
i aencaranise SAAT eet Lee see ston eae! si 
MACRO INSTRUCTION PROTOTYPE 
The macro inStruction prototype state- 
ment (hereafter called the prototype 
statement) specifies the mnemonic operation 
code and the format of all macro 
instructions that refer to the macro 
definition. It must be the second state- 


ment of every macro definition. The format 


of this statement is: 


ae ee Tere ae tn 1 
| Name {Operation |Operand | 
[~-----~-----}---------- 4----------------- { 
JA symbolic |A symbol |One or more sym- | 
|parameter | [bolic parameters | 
for blank | | separated by com-| 
| | |mas, or blank | 
Wea eee tot on cee ere ET Pee se so eee r) 

Th: symbolic parameters are used in the 


macre definition to 
field and operands of the corresponding 
macro instruction. A description of 
symbolic parameters appears under “Symbolic 
Parameters." 


represent the name 


The name field of the 
Ment may be blank, or 
symbolic parameter. 


prototype state- 
it may contain a 


The symbol in the operation field is the 
mnemonic operation code that must appear in 


all macro instructions that refer to this 
macro definition. The mnemonic operation 
code must not be the same aS the mnemonic 


operation code of another macro definition 
in the source program or of a machine or 
assembler instruction as listed in Appendix 
G. 


The operand field may contain 0 to 200 
symbolic parameters separated by commas. 
If there are no symbolic parameters, com- 
ments may not appear. 
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The following is an example of a 
prototype statement. 


Carer er aanaEaE Tre eo Tey eee Sa ey ee s) 
| Name |Operation |Operand | 
—~=----4---------~- $o------ =~ 
[&NAME | MOVE | &TO, &FROM | 
Loceeooe y ESpeeee meme a babi sa setae seas eel J 


Statement Format 


The prototype statement may be written 
in a format different from that used for 
assempler language statements. The normal 
format is described in Part I of this pub- 
lication. The alternate format described 
here allows the programmer to write an 
operand on each Line, and allows the inter- 
spersing of operands and comments in the 


statement. 
In the alternate format, as in the 
normal format, the name and operation 


fields must appear on the first line of the 
statement, and at least one blank must 
follow the operation field on that line. 
Both types of statement formats may be used 
in the same prototype statement. 


The rules for using the alternate state- 
ment format ares 


1. If an operand is followed by a comma 
and a blank, and the column after the 
end column contains a nonblank charac- 
ter, the operand field may be contin- 
ued on the next line starting in the 
continue column. More than one oper- 
and may appear on the same line. 


2. cCommentS may appear after the blank 
that indicates the end of an operand, 
up to and including the end column. 


3. If the next line starts after the 
continue column, the information 
entered on the next line is considered 
comments, and the operand field is 
considered terminated. Any subsequent 
continuation lines are considered com- 
ments. 


Note: A prototype statement may be written 
on aS many contiruation lines as necessary. 
When uSing normal format, the operands of a 
prototype statement must begin on the first 
statement line or in the continue column of 
tne second line. 


The following examples illustrate: (1) 
the normed statement format, (2) the alter- 
nate statement format, and (3) the combine- 
tion of reth statement formats. 
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ara acannon ea a ba cl ara ™71 
|Name |Oper- |Operand Comments| | 
| jation| 1 | 
ono aaa =- tennnn pon nnn nnn nnn nnn nF | 
| NAME1 jOPi |OPERAND1,OPERAND2,OPERAN|X| 
| | [D3 THIS IS THE NORMAL 1X] 
| | | STATEMENT FORMAT | | 
p-~------ | eign COnmarod a agence nga a tA 
| NAME2 jOP2 |OPERAND1, THIS IS THE AL|X| 
{ | j}OPERAND2,OPERAND3, TERNA|X| 
| 1 ] TE STATEMENT FORMAT in| 
}-------- t----- foo nn nine nn nnn nanan a= t-4 
| NAME 3 |OP3 |OPERANDi, THIS IS A COMB|X| 
| | | OPERAND2, OPERAND3 , OPERAN |X| 
{ | |D4,OPERAND5 INATION OF |X] 
| | |BOTH STATEMENT FORMATS | | 
tool loos Fee te cos a eon a os a es a LJ 


MODEL STATEMENTS 


Model statements are the macro definition 
statements from which the desired sequences 
of assembler language statements are 
generated. Zero or more model statements 
may follow the prototype statement. A 
model statement consists of one to four 
fields. They are, from left to right, the 
name, operation, operand, and comments 
fields. 

The fields in the model statement must 
correspond to the fields in the generated 
statement. It is not possible to generate 
blanks to separate statement fields. 


Model statement fields must follow the 
rules for paired apostrophes, ampersands, 
and blanks as macro instruction operands 
(see "Macro Instruction Operands" in 
Section 8). 


Though model statements must follow the 
normal continuation card conventions, 
statements generated from model statements 
may have more than two continuation lines. 
Substituted statements may not have blanks 
in any field except between paired apostro- 
phes. They may not have leading blanks in 
the name or operand fields. 


Name Field 


The name field may be blank or it may 
contain an ordinary symbol, a variable 
symbol, or a sequence symbol. It may also 
contain an ordinary symbol concatenated 
with a variable symbol or a variable sym- 
bol concatenated with one or more other 
variable symbols. 


Variable symbols may not appear in the 
name field of ACTR, COPY, END, ICTL, ISEQ, 
or OPSYN statements. The characters * and 
.* may not be substituted for a variable 


symbol. 
Operation Field 


The operation field may contain a 
machine instruction, an assembler instruc- 


tion listed in Section 5 (except END, ICTL, 
ISEQ, OPSYN, or PRINT), a macro instruction, 
or variable symbol. It may also contain an 
ordinary symbol concatenated with a variable 
symbol or a variable symbol concatenated 
with one or more other variable symbols. 


Variable symbols may not be used to 
generate 


@® Macro instructions, 


@e Assembler instructions appearing 
outside of Section 5, or 


@ END, ICTL, ISEQ, OPSYN, PRINT, or 
REPRO instructions. 


Variable symbols may also be used outside 
of macro definitions to generate mnemonic 
operation codes with the preceding 
restrictions. 


The use of COPY instructions is de- 
scribed under "COPY Statements". 

Variable symbols in the line following 
a REPRO instruction, will not be replaced 
by their values. 


Operand Field 


The operand field may contain ordinary 
symbols or variable symbols. However, 
variable symbols may not be used in the 
operand field of COPY, END, ICTL, ISEQ, 
or OPSYN instructions. 


Comments Field 


The comments field may contain any 
combination of characters. No substitution 
is performed for variable symbols appearing 
in the comments field. Only generated 
statements will be printed in the listing. 


SYMBOLIC PARAMETERS 


A symbolic parameter is a type of varia- 
ble symbol that is assigned values by the 
programmer when he writes a macro 
instruction. The programmer may vary 
statements that are generated for each 
occurrence of a macro instruction by vary- 
ing the values assigned to symbolic peram- 
eters. 


A symbolic parameter consists of an 
ampersand followe@ by from one through 
seven letters and/or digits, the first of 
which must be a letter. #&lsewhere, two 
ampersands must be used to represent an 
ampersand. 

The programmer should not use &SYS as 
the first four characters of a symbolic 
parameter. 


Section 7: 


The following are valid symbolic paran- 
eters: 

&READER & LOOP2 
&A23456 éN 
EX4UF2 &$4 

The following are invalid symbolic pa- 
rameters: 

CARDAREA (first character is not an 
ampersand) 

&256B (first character after 
ampersand is not a 
letter) 

SAREA2456 (more than seven characters 
after the ampersand) 

&BCD% 34 (contains a special charac- 
ter other than initial 
ampersand) 

6IN AREA (contains a special charac- 
ter, i.e., blank, other 
than initial anpersand) 

Any symbolic parameters in a model 
statement must appear in the prototype 
statement of the macro definition. 

The following is an example of a macro 
definition. Note that the symoolic 


parameters in the motel statements appear 
in the prototype statement. 


acter aaa Tenors Wee sry Se Tess q 
|Name |Operation |Cperand | 
p------- ponnn anno $o----------- 4 
Header | | MACRO | | 
Prototype|&NAME {MOVE | &TO, 6FROM | 
Model [|6NAME [ST |2,SAVE \ 
Model | L | 2,6FROM | 
Model | {Sst |2,6TO | 
Model | | L |2,SAVE | 
Trailer | ] MEND | | 
| Rese apeanee Bo ee eS Pe Saree Soe J 


Symbolic parameters in model statements 
are replaced py the characters of the 
macro instruction that correspond to the 
symbolic parameters. 


In the following example the characters 
HERE, FIELDA, and FIFLDB of the MOVE macro 
instruction correspond to the symbolic 
parameters &NAMF, &TO, and &FROM, respec- 


tively, of the MOVE prototype statement. 

C25 STS Te Se ee ee ee 1 
[Name [Operation |Operand | 
sae ao- fow-=++-----f----- 7 === 
{HERE |MOVE | FIELDA, FIELDB { 
totes boss ocoe oes 4 re Ne em J 


Any occurrence of the symbolic parame- 
ters &NAME, &TO, and 6FROM in a model 
statement will be replaced by the charac- 
ters HERE, FIELDA, and FIELDB, respective- 
ly. If the preceding macro instruction was 
used in a source program, the following 
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assembler language statements would be gen- 
erated: 


feo er h ieee ean mae Ys SS ee ane 1 
[Name |Operation {fOperand | 
t------ to----- === fow—a ano ~ === === 4 
[HERE |S% | 2, SAVE { 
| \L | 2, FIELDA | 
| {ST {2,FIRLDA i 
| |L | 2, SAVE | 
took is ie See ie Wee 2 eee ee 4 

The example below illustrates another 





use of the MOVE macro instruction using 
operands different from those in the 
preceding example. 
(a ge be oe Ne ee 1 
| Name |Operation |Operand | 
[------~+----------- $---~~------- { 
Macro |LABEL |MOVE | IN, OUT | 
~~--~--}----------- +-----~------ { 
Generated|LABFL |ST |2, SAVE 
Generated| [L | 2, OUT | 
Generated | [st |2, IN i 
Generated] |L {2,SAVE | 
te 2255s Hie eS SSS Loloe oo Se 4 


If a symbolic parameter appears in the 
comments field of a model statement, it is 
not replaced by the corresponding charac- 
ters of the macro instruction. 


Concatenating Symbolic Parameters with 








Parameters 


It a symbolic parameter in a model 
statement is immediately preceded or fol- 
lowed by other characters or another sym- 
bolic parameter, the characters that cor- 
respondad to the symbolic parameter are com- 
bined in the generated statement with the 
other characters or the characters that 
correspond to the other symbolic parameter. 
This process is called concatenation. 


The macro definition, macro instruction, 


and generated statements in the following 
example illustrate these rules. 
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ara Tr eR een ee 1 
{Name |Operation|Operand | 


Header | 


Prototype | NAME | MOVE | &TY,&P,&TO, &FROM 


| 

Model | SNAME|ST&TY |2,SAVEAREA | 
Model | | LETY }2, &PEFROM | 
Model { |ST&TY {2,&PETO | 
Model | |LETY [2, SAVEAREA | 
Trailer | | MEND | | 
SSueatee ee eo eo he Se Se ee 4 

Macro |HERF [MOVE |D, FIELU,A,5 | 
Siete ee ee ee { 
Generated|HERE | STD |2, SAVEAREL | 
Generated | {LD |2, FIELDS | 
Generated | {STD {2,FIELDA | 
senerated| {Ld |2, SAVEAREA | 
eee BS aaa oes Wee et oe J 

The symbolic parameter &TY is used in 


each of the four model statements tc vary 
the mnemonic operation code of each of the 
generated statements. The character D in 
the macro instruction corresponds to sym- 
bolic parameter &TY. Since &TY is preceded 
by other characters (i.e., ST and L) in the 
model statements, the character that cor- 
responds to 6&TY (i.e., D) is concatenated 


with the other characters to form the 
operation fields of the generated state- 
ments. 


The symbolic parameters 6&P, &TO, and 
§PROM are used in two of the model state- 
ments to vary part of the operand fields of 
the corresponding generated statements. 
The characters FIELD, A, and B- correspond 
to the symbolic parameters 6P, &TO, and 
&FROM, respectively. Since 6P is followed 
by &FROM in the Second model statement, the 
characters that correspond to them (i.e., 
FIELD and B) are concatenated to form part 
of the operand field of the second generat- 
ed statement. Similarly, FIELD and A are 
concatenated to form part of the operand 
field of the third generated statement. 


If the programmer wishes to concatenate 
a symbolic parameter with a letter, digit, 
left parenthesis, or period following the 
symbolic parameter he must immediately fol- 
low the symbolic parameter with a period. 
A period is optional if the symbolic param- 
eter is to be concatenated with another 


Features not shown below are common to all assemblers. In the chart: 
Dash = Not allowed. 
x As defined in Operating System/360 Assembler Language Manual. 
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Maximum Characters per symbol 6 fe pe | 
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Expressions allowed as modifiers 
Multiple operands 


Multiple constants in an operand 
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Scale modifier 


DC types 


DC duplication factor 
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2DOS 14K D Assembler only 
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Macro Facility Features 






Operand Sublists 





Attributes of macro-instruction operands inside macro definitions and symbols used in 
conditional assembly instructions outside macro definitions. 


Subscripted SET symbols 







Maximum number of operands 


Conditional assembly instructions outside macro definitions 





Maximum number of SET symbols 








global SETA 


global SETB 






global SETC 


local SETA 








local SETB 


local SETC 






BPS 8K Tape, 
BOS 8K Disk 
Assemblers 


BOS 16K 
Disk/Tape 


Assembler 





OS/360 
Assembler 





200 





* The number of SET symbols permitted is variable, dependent upon available main storage. 


Note: The maximum size of a character expression is 127 characters for the pos/Tos' Assembler D and 


255 characters for the OS Assembler F. 


} 200 for Assembler F 
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The macro definitions in this appendix are 
typical applications of the macro language 
and conditional assembly. Another macro 
definition is included in the sample pro- 
gram as part of Appendix H. 


MEMBER NAME SAVE 
MACRO 
ENAME SAVE GREG ECODE, EID 
LCLA &A,66+fC 
LCLC GE, E&F,6G,EH 
AIF (*EREG® EQ *").EL 
AIF (*eIpt EQ © ).NULLID 


AIF (*EIN* EQ "#*).SPECED 
GA SETA ((KPETD+2)/2) 4244 
ENAME 8 EAL(0015) BRANCH AROUND [0D 
GA SETA K*étbd 


oc ALL{E€A) 
-«CONTB AIF (GA SF 32).SPLITUP 
eCONTAA AIF (GA GT 8).BRAKOWN 
cE SETC ‘E1D* (eB+1» GA} 

oc CLEA'EE® 

AGO CONTA 
«BRAKOWN ANOP 


LOENTIFIER 


GE SETC *610'(68+1,8) 

oc CLBtGE? IDENTIFIER 
6B SETA &6+8 
&A SETA 64-8 


AGO »CONTAA 
~@SPLITUP ANOP 


6E SETC *E10'(6b41,8) 
cr SETC *&10'(&B+9,8) 
6G SETC *E1D*( 8641758) 
6H SETC "E10"(E84+2558) 
DC CL32°6E.GF. EG. EH* IDENTIFIER 
6B SETA &B8+32 
6A SETA §A-32 


AGO CONT 
eNULLID ANOP 
ENAME DS OH 
AGO oCONTA 
eSPECID AIF (*ENAME* EQ **).CSECTN 


GE SETC ‘*ENAME® 
GA SETA 1 
-CONTQ AIF C'EENCL, EA) EQ *EE*) LEAVE 


€A SETA GA+1 
AGO eCONTQ 
LEAVE ANOP 
6B SETA ((EA42)/2) #244 
ENAME B 8.10915) 
oc ALL (EA) 
oc CLEA‘ EEF 
AGO »CONTA 
eCSECTN AIF C*ESYSECT® EQ *4).E4 


IDENTIFIER 


€e SETC ‘&SYSECT! 
GA SETA 1 
AGO «CONTQ 
a E4 THBERMAC 782360 CSECT NAME NULL 


«CONTA AIF (TPEREG(L) NE 'N*).E3 
AIF C'ECODE?® EQ 'T'}.CONTC 


AIF {"ECGDE® NE **).62 
oA SETA GREG(1)#4+20 
AIF {6A LE 75).CONTD 
GA SETA 6A-64 
»CONTD AIF {N'EREG NE 2).CONTE 
STM EREG(1) ,EREG(2) 9A. (13) SAVE REGISTERS 
MEXIT 
CONTE AIF (N*EREG NE 1).53 
ST EREGU1) -6A. (1340) SAVE REGISTER 
MEXIT 
eCONTC AIF ({EREGIL) GE 14 OR EREGEL) LE 2).CONTF 
STM 14,15912(13) SAVE REGISTERS 
GA SETA &6REG(1)#4+20 
AIF (N'tEREG NE 2).CONTG 
ST™ EREG(1) eGREG(2)56A.(13) SAVE REGISTERS 
MEXIT 
«CONTG AIF (N*EREG NE 1).E3 
st GREG(1) GA. (1340) SAVE REGISTER 
MEXIT 


LENGTH OF IDENTIFIER 


BRANCH AROUND [D 


Appendix J: 


APPENDIX J: SAMPLE MACRO DEFINITIONS 





Notice the use of the inner macro in- 
struction (IHBERMAC) within SAVE for the 
purpose of generating MNOTE statements. 
Included with SAVE are some examples of the 
statements generated from it. 


90920000 
00040000 
90960000 
90080000 
90100009 
90120000 
0014000 
90 160000 
00180000 
00200000 
00220000 
90240000 
0260000 
90280000 
90300000 
00320009 
00 340000 
90 360000 
00340000 
00400000 
00420000 
00440000 
00460000 
00480000 
00500000 
00520000 
00540000 
90560000 
0¢580000 
00600000 
90620000 
09640009 
00660000 
00680009 
00700000 
00720000 
00740000 
00760000 
0u 780000 
90800000 
90820C00 
00840000 
00860009 
009880009 
90900000 
00920000 
00940000 
00960000 
00980000 
91000000 
01020000 
01040000 
01060000 
OL080000 
01100000 
01120000 
91140000 
01160600 
01180000 
01200000 
01220000 
01240000 
01260000 
01280000 
01300000 
01320000 
Q1340000 
01 360000 
01380000 
01400000 
01420000 
01440600 
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«CONTE 


«CONTH 


oEL 
2E2 


2&3 


AIF {N'EREG NE 2).CONTH 

STM 14,6REG(2),12113) SAVE REGISTERS 
MEXTT 

AIF {N'EREG NE 1).E3 

ST™ 14,6REGE1) 12013) SAVE REGISTERS 
MEXTY 

IHBERMAC 184360 REG PARAM MISSING 
MEXIT 

THBERMAC 37, 360,+6CODE INVALIO COGE SPECIFIED 
MEXIT 

THBERMAC 36, 360,EREG INVALIO REGS. SPECIFIED 
MEND 


END OF DATA FOR SDS OR MEMBER 


FOGHORN 
FOGHORN 


SAVMACRO 
SAVMACRO 


SAVE 
oS 
STH 


SAVE 
OS 


SAVE 


STM 


MEMBER NAME 


ENAME 


ENAME 


oERR 


NOTE 
AIF 


SAMPLE SAVE MACRO ENSTRUCTIONS 


(14,12) 
OH 
14512,12¢13)} SAVE REGISTERS 


PORSRBEDEaS 


(REG14,REG12)T 
OH 
12,280 [HBOO2 INVALID FIRST OPERANO SPECIFIED-(REGI4sR 


C1412) 0Te® 

14(0,15) BRANCH AROUND ID 
ALL(B) 

CLE*SAVHACRO® LOENTIFIER 


14912512013) SAVE REGESTERS 


NOTE 
MACRO 


€DCB 
(*LOCK" EQ t*) ERR 


IHBINNRA &0CB 


L 
BALR 


MEXTT 


15, 84(0,1) LUAD VOTE RTN ADDRESS 
14515 LINK TO NOTE ROUTINE 


THBERMAC 6 


MEND 


MEMBER NAME 


ENAME 


ENAME 


aERRI 


aERR2 


POINT 
MACRO 


POINT &DC8,6L0C 


AIF 
AIF 


('EDCB EQ #*),ERRI 
(PELOC! EQ **).ERR2 


ITHBINNRA €0CByELOC 


L 
BAL 


MEXTT 


155 84(O-L) LOAD POINT RTN ADDRESS 
1424(15,9) LINK TO POINT ROUTINE 


THBERMAC 6 


MEXIT 


EHBERMAC 3 


MEND 


MEMBER NAME 


ENAME 


ENAME 


EX 
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CHECK 
MACRO 


CHECK GDECH 


ATE 


(*EDECB' EQ '*).EL 


THBINNRA &EDECB 


L 


t 


BALR 


MEXIT 


14,8(0s1) PICK UP DCB ANDRESS 
1555210514) LUAD CHECK RUUT. ATDR. 
14415 LINK TQ CHECK ROUTINE 


THBERMAC 075018 


END 


01460000 
01480000 
01500000 
91520000 
01540000 
01560000 
01580000 
01600000 
01620000 
01640000 
01660900 
0L680000 


00020600 
90040000 
00060000 
90080000 
09100000 
90120000 
00140009 
90160000 
96180000 


00920000 
90040000 
00060000 
00080000 
00100000 
00120000 
00140090 
90160090 
00180000 
00200090 
90220900 
00240000 


00020000 
00040000 
00060000 
00080000 
00 100G0U0 
00120009 
00140009 
00 L60000 
0g180C90 
00200000 
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&SYS,restrictions on use 67,81,95 


&SYSECT (see current control section name) 
&SYSLIST (see macro instruction operand) 
&SYSNDX (see macro instruction index) 


7090/7094 Support Package Assembler 


Absolute expressions 17,29 
Absolute terms 10 

ACTR instruction 89 

Address constants 47-49 


A-type 47 
Complex relocatable expressions 
Literals not allowed 15 
Q-type 48 
S-type 48 
V-type 48 
Y-type 47 
Address specification 30 
Addressing 
Dummy sections 24 
Explicit 19 
External control sections 28 
Implied 19 
Relative 21 
AGO instruction 89 
AIF instruction 88 
Alignment, boundary 
CNOP instruction for 56 
Machine instruction 29 
Ampersands in 
Character expressions 83 
Macro instruction operands 71 
MNOTE instruction 94 
Symbolic parameters 67 
Variable symbols 62,140 
ANOP instruction 90 
Apostrophes 
Character expressions 84 
Macro instruction operands 71 
MNOTE instruction 94 
Arithmetic expressions 
Arithmetic relations 86 
Evaluation procedure 82 
Invalid examples 82 
Operand sublists 72 
Operators allowed 81 
Parenthesized terms 
evaluation 82 
examples 82 
SETA instruction 81 
SETB instruction 86 
Substring notation 84 
Terms allowed 81 
Valid examples 81 
Arithmetic relations 86 
Arithmetic variable 98 
Assembler instructions 
Statement 35,133 
Table 131 
Assembler language 
Basic Programming Support 
Comparison chart 145 
Macro language, relation to 61 
Statement format 8,9 
Structure 10,11 


9,145 


3,145 


47 


Assembler program 
Basic functions 4 
Output 22 
Assembly, terminating ar 58 
Assembly no operation (see ANOP 
instruction) 
Attributes 
How referred to 77 
Inner macro instruction operands 76 
Notations 76 
Operand sublists 76 
Outer macro instruction operands 76 
Summary chart 139 
Symbols 76 
Types 76 
Use 76 
(see also specific attributes) 


Basic Programming Support Assembler 
Base registers 
Address calculation 
DROP instructions 20 
Loading 20 
USING instructions 19 
Begin column 8,53,54 
Binary constant 43 
Binary self-defining term 13 
Binary variable 98 
Blanks 
Logical expressions 86 
Macro instruction operands 71 
ccwW instruction 50 
Channel command word, defining 51 
Character codes 107 
Character constant 42 
Character expressions 
Ampersands 84 
Apostrophes 84 
Character relations 86 
Examples 84 
Periods 84 
SETB instructions 86 
SETC instructions 83 
Character relations 86 
Character self-defining term 13 
Character set 15,107 
Character variable 98 
CNOP instruction 56 
Coding form 7 
Columns (begin, continue, end) 8,53,54 
COM instruction 26 
Commas, macro instruction operands 72 
Comment Entry 9 
Comment statements 
Example 69 
Model statements 69 
Not generated 69 
Comparison chart 145 
Compatibility 
Assembler language 3 
Macro definitions 104 
Complex relocatable expressions 47 
Concatenation 
Character expressions 
Defined 68 


3,145 


4,28,30 


83,85 


Index 151 


Examples 63 
Substring notations 85 
Conditional assembly elements, summary 
charts of 90,138 
Conditional assembly instructions 
How to write 75 
Summary 75 
Continue column 8,53,54 
Use 75 
(see also specific instructions) 
Conditional branch (see AIF instruction) 
Conditional branch instruction 32 
Operand format 33 
Constants (see also specific types) 
Defining (see DC instructions) 
Summary 135 
Continuation lines 7 
Control dictionary 22 
Control section location assignment 22 
Control sections 
Blank common 26 
CSECT instruction 23 
Defined 22 
First control section, properties of 
START instruction 23 
Unnamed 24 
COPY instruction 57 
COPY statements in macro definitions 
Format 70 
Model statements, contrasted 70 
Operand field 70 
Use 69 
Count attribute 
Defined 79 
Notation 79 
Operand sublists 79 
Use 78 
Variable symbols 79 
CSECT instruction 
Length attribute 23 
Symbols 23 
Current control section name (&SYSECT) 
Affected by CSECT,DSECT,START 99 
Example 100 
Use 99 
CXD instruction 25 


Data definition instructions 36 
Channel command words 50 
Constants 36 
Storage 48 

DC instruction 36 
Constant operand subfield 41 

Address constant (see Address 
constants) 
Binary constant 43 
Character constant 42 
Decimal constant 46 
Fixed-point constant 43 
Floating-point constant 44 
Hexadecimal constant 42 
Type codes for 38 
Exponent modifier 41 
Duplication factor operand subfield 


152 


23 


38 


Length modifier 39 
Bit length specification 39 
Modifiers operand subfield 38 
Scale modifier 40 
Type operand subfield 38 
Decimal constants 46 
Length, maximum 46 
Length modifier 39 
Packed 46 
zoned 46 
Decimal field, integer attribute of 80 
Decimal self-defining terms 12 
Defining constants (see DC instruction) 
Defining storage (see DC instruction, 
DS instruction) 
Defining symbols 12 
Dimension, subscripted SET symbols 97 
Displacements 29 
Double-shift instruction 29 
DROP instruction 20,29 
DS instruction 48-50 
Defining areas 50 
Forcing alignment 50 
DSECT instruction 24 
Dummy section location assignment 24.1 
Duplication factor 38 
Forcing alignment 50 
DXD instruction 25 


Effective address, length 30 
EJECT instruction 52 
End column 8,53,54 


END instruction 58 

ENTRY instruction 27 

Entry point symbol, identification of 27 
EQU instruction 35 

Equal signs, as macro instruction operands 


Exror message (see MNOTE instruction) 
Error messages after END statement 58 
Explicit addressing 19,30 

Length 30 
Exponent modifiers 41 
Expressions 16 

Absolute 17 

Evaluation 16 

Relocatable 17 

Summary chart 138 
Extended mnemonic codes 32 

Operand format 33 
External control section, addressing of 28 
External dummy sections 25 
External symbol, identification 28 
EXTRN instruction 28 


First control section 23 
Fixed-point constants 44 

Format 43 

Positioning 44 

Scaling 44 

Values, minimum and maximum 44 
Fixed-point field, integer attribute of 78 
Floating-point constant 44 

Alignment 45 


Format 45 

Scale modifiers 45 
Floating-point field, integer attribute 
of 78 
Format control, input 53 


GBLA instruction 95 
GBLB instruction 95 
GBLC instruction 95 
General register zero, base register 
usage 20 
Generated statements, examples of 68 
Global SET symbols 63 
Defining 95 
Examples 96,97 
Local SET symbols, compared 94 
Use 94 
Global variable symbols 
Types 94 
(see also global SET symbols, 
subscripted SET symbols) 


Hexadecimal constants 42 

Hexadecimal-decimal conversion chart 
113-117 

Hexadecimal self-defining terms 13 


I' (see integer attribute) 
ICTL instruction 53 
Identification-sequence field 9 
Identifying assembly output 51 
Identifying blank common control section 
26 
Identifying dummy section 25 
Implied addressing 30 
Length 31 
Implied length specification 31 
Inner macro instruction 
Defined 73 
Examples 74 
Symbolic parameters 73 
Instruction alignment 29 
Integer attribute 
Decimal fields 78,80 
Defined 78,79 
Examples 79,80 
Fixed-point fields 78,79 
Floating-point fields 78,80 
How to compute 79 
Restrictions on use 78 
Symbols 78 
ISEQ instruction 54 


K' (see count attribute) 

Keyword 
Defined 100 
Keyword macro definitions 101 
Keyword macro instruction 101 
Symbolic parameter and 101 


Keyword, inner macro instructions used in 
102 


Keyword macro definition 


Positional macro definitions, compared 
101 


Use Lol 
Keyword macro instruction 
Example 101 
Format 101 
Operand sublists 102 
Operands 
Invalid examples 101 
Valid examples 102 
Keyword prototype statement 
Example 101 
Format 101 
Operands 
Invalid examples 101 
Valid examples 101 
Standard values 101 


L' (see length attribute) 
LCLA instruction 81 
LCLB instruction 81 
LCLC instruction 81 
Length attribute 
Defined 15,78 
Examples 78 
Restrictions on use 76 
Symbols 15,79 
Length modifier 39 
Bit-length specification 39 
Length subfield 29 
Lengths, explicit and implied 30 
Library, copying coding from 57 
Linkage symbols (see also ENTRY 
instruction, EXTERNAL instruction) 
Entry point symbol 27 
External symbol 28 
Linkage editor, and use of 25-27 
Listing, spacing 52 
Listing control instructions 51 
Literal pools 14,55 
Literals 14 
Character 15 
Dc instruction, used in 15 
Definitions 37 
Duplicate 56 
Format 15 
Literal pool, beginning (LTORG) 55 
Literal pools, multiple 15 
Local SET symbols 
Defining 95 
Examples 95-97 
Global SET symbols, compared 94 
Local variable symbols 
Types 94 
(see also local SET symbols and 
subscripted SET symbols) 
Location counter 


CSECT 22 
Definition 14 
DSECT 24 
How to set 
ORG 55 
START 23 


Use in address constants 42,47 
Logical expressions 


Index 153 


AIF instructions 88 


Arithmetic relations 86 
Blanks 86 
Character relations 86 


Evaluation 87 
Invalid Examples 87 
Logical operators 86 
Parenthesized terms 
Evaluation 87 
Examples 87 
Relation operators 86 
SETB instructions 86 
Terms allowed 86 
Valid examples 87 
LTORG instruction 55 
Machine-instruction examples and format 


RR 29,31 

RS 29,32 

RX 29,32 

SI 29,32 

SS 29,32 

Summary table 119 
Machine-instruction mnemonic codes 31 


Alphabetical listing 122 
By duration code 129 
Machine instructions 29 
Alignment. and checking 29 
Literals, limits on 14 
Mnemonic operation codes 31 
Operand fields and subfields 29 
Symbolic operands 31 
MACRO 
Format 65 
Use 65 
Macro library defined 61 
Macro definition 
Compatibility 104 
Defined 61 
Error flagging 58 
Example 67 
Header 65 
How to prepare 65 
Keyword (see Keyword macro definition) 
Mixed-mode (see Mixed-mode 
macro definition) 
Placement in source program 65 
Trailer 65 
Use 61 
Macro definition exit (see MEXIT 
instruction) 
Macro definition header statement (see 
MACRO) 
Macro definition trailer statement (see 
MEND) 
Macro instruction 
Defined 61 
Example 67 
Format 71 
How to write 71 
Levels 74 
Mnemonic operation code 71 
Name field 71 
Omitted operands 72 
Examples 72 


154 


Operand field 71 
Operand sublists 72 
Operands 
Ampersands 72 
Apostrophes 71 
Blanks 72 
Commas 72 
Equal signs 71 
Parentheses 71 
Operation field 71 
Statement format 72 
Types 61 
Macro instruction index (&SYSNDX) 
Examples 99 
Use 98 
Macro instruction operand (&SYSLIST) 
Attributes 100 
Use 100 
(see also symbolic parameters) 
Macro instruction prototype statement (see 
prototype statement) 
Macro instruction statement (see macro 
instruction) 
Macro language 
Comparison chart 147 
Extended features 93 
Relation to assembler language 61 
Summary 91,137-140 


MEND 
Format 65 
MEXIT instruction, contrasted 93 
Use 65 
MEXIT instruction 
Example 93 
Format 93 
MEND, contrasted 93 
Mixed-mode macro definitions 
Positional macro definitions, 
contrasted 103 
Use 103 
Mixed-mode macro instruction 103 
Mixed-mode prototype statement 103 
Mnemonic operation codes 29,31 
Extended 32 
Machine instruction 31 
Macro instruction 65 
MNOTE instruction 
Ampersands 94 
Apostrophes 94 
Error message 94 
Examples 94 
Format 93 
Severity code 94 
Model statements 
Comments field 67 
Defined 66 
Name field 66 
Operand field 67 
Operation field 66 


N' (see Number attribute) 
Name entry 8 


Number attribute 
Defined 79 
Examples 79 


Operand sublist 
Alternate statement format 72 
Defined 72 
Examples 73 


Operands 
Entries 8 
Fields 29 
Subfields 29,30 
Symbolic 27,29,30 


Operating system 5 
Operation field 29 
OPSYN instruction 

ORG instruction 55 
Outer macro instruction defined 73 


35,36 


Paired apostrophes 71 
Paired parentheses 71 
Parentheses 
Arithmetic expressions 82 
Logical expressions 87 
Macro instruction operands 71 
Operand fields and subfields 29 
Paired 71 
Period 
Character expressions 84 
Comments statements 69 
Concatenation 68 
Sequence symbols 80 
Positional macro definition (see macro 
definition) 
Positional macro instruction (see macro 
definition and macro instruction) 
Previously defined symbols 12 
PRINT instruction 52 
Program control instructions 53 
Program listings: 5 
Program sectioning and linking 22 
Prototype statement 
Examples 66 
Format 65 
Keyword (see keyword prototype 
statement) 
Mixed-mode (see mixed-mode prototype 
statement) 
Name field 65 
Operand field 65 
Operation field 65 
Statement format 
Alternate 66 
Normal 66 
Symbolic parameters 65 
Pseudo Register (see DXD instruction) 
PUNCH instruction 54 


Quotation marks (see Apostrophes) 
Quoted string 71 


Relational operators 86 
Relative addressing 21 
Relocatability 4,10,11 


Attributes 17 

Program, general register zero 20 
Relocatable expressions 17,29 

In USING instructions 20 


Relocatable terms 10,11 
Pairing of 17 
In relocatable expressions 17 


REPRO instruction 55 
RR machine instruction 


RS 


RX 


Ss! 


Format 31,119 

Length attribute 29 
machine instruction 
Address specification 30 
Format 32,119 

Length attribute 29 
machine instruction 
Address specification 30 
Format 32,119 

Length attribute 29 


(see scaling attribute) 


Sample program 141 
Scale modifier 


Fixed-point constants 43 
Floating-point constants 45 


Scaling attribute 


Decimal fields 78 
Defined 78 

Examples 78 

Fixed-point fields 78 
Floating-point fields 78 
Restrictions on use 78 
Symbols 78 


Self-defining terms 12 

(see also specific terms) 
Sequence checking 54 
Sequence symbols 


AGO instruction 89 
AIF instruction 88 
ANOP instruction 90 
How to write 80 
Invalid examples 80 
Macro instruction 80 
Valid examples 80 


Set symbols 


Assigning values 75 

Defining 75 

Symbolic parameters, contrasted 75 

Use 75 

(see also local SET symbols, global SET 
symbols, and subscripted SET symbols) 


SET variable 94 
SETA instruction 


Examples 81-83 

Format 81 

Operand field 
Evaluation procedure 
Operators allowed 81 
Parenthesized terms 82 
Terms allowed 81 
Valid examples 82 

Operand sublist 82 
Examples 82 


81,82 


SETA symbol 


Arithmetic relations 82 
Assigning values to 82 
Defining 75,82 

Use 82 


SETB instruction 


Examples 86 
Format 86 
Logical expressions 86 
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Arithmetic relations 86 
Blanks 87 
Character relations 86 
Evaluation 87 
Operators allowed 86 
Terms allowed 86 
Operand field 84 
Invalid examples 87 
Valid examples 87 
SETB symbol 
AIF instruction 87 
Assigning values 75 
Defining 75 
SETA instructions, use in 87 
SETB instructions, use in 87 
SETC instructions, use in 87 
SETC instruction 
Character expressions 83 
Ampersands 84 


Apostrophes 83,84 
Periods 84 
Concatenation 
Character expressions 84 
Substring notation 84 
Examples 83,85 


Format 83 
Operand field 83 
Substring notations 


Arithmetic expressions 84 
Character expressions 84 
Invalid examples 85 


Valid examples 85 
Type attribute 83 
Examples 83 
SETC symbol 
Assigning values 85 
Defining 75,85 
SETA instruction, use in 86 
Sevérity code in MNOTE instruction 
SI machine instruction 
Address specification 30 
Format 32,119 
Length attribute 29 
SPACE instruction 51 
SS machine instruction 
Address specification 30 
Format 32,119 
Length attribute 29 
length field 30 
Standard value 
Attributes 102 
Keyword prototype statement 101 
START instruction 
Positioning 23 
Unnamed control sections 24 
Statements 8,9 
Boundaries 8 
Examples 9 
Macro instruction 71 
Prototype 65 
Storage, defining (see DS instruction) 
Sublist (see Operand sublist) 
Subscripted SET symbols 
Defining 97,98 
Examples 97 
Dimension 98 
Invalid examples 97 


93,94 
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Subscript 95 
Use 98 r 
Examples 98 
Valid examples 97 
Substring notation 
Arithmetic expressions 84 
Character expression 84 
Invalid example 85 
SETB instruction 86 
SETC instruction 85 
Valid examples 85 
Symbol definition, EQU instruction for 12 
Symbolic linkages 27 
Symbolic operand formats 31 
Symbolic parameters 
Assigning values 67 
Comments field 66 
Concatenation 68 
Defined 67 
Examples, invalid and valid 67 
Prototype statement 65 
(see also variable symbols) 
Symbols 
Defining 12 
Length attributes 
Length, maximum 12 
Previously defined 12 
Restrictions 12 
Value attributes 29 
System macro instructions defined 62 
System variable symbols 
Assigned values by assembler 98 
Defined 98 
(see also specific system variable ‘ 
symbols) 


15,29 


T' (see type attribute) 

Terms 
Expressions composed of 10 
In parentheses 16 
Pairing of 16 

TITLE instruction 51 

Type attribute 
Defined 77 
Literals 77 
Macro instruction operands 77 
SETB instruction 86 
SETC instruction 83 
Symbols 77 


Unconditional branch (see AGO instruction) 
Unnamed control section 24 
USING instruction 19 


Variable symbols 
Assigning values 63 
Defined 62 
Summary chart 140 
Types 62 
Use 62 
(see also specific variable symbols) 
V-type address constant 48 
WXTRN instruction 28.1,48 
XFR instruction 3 


Y-type address constant AT 4 
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